UNIX™ System V — Release 2.0 

Programmer Reference Manual 
DEC™ Processors 



UNIX is a trademark of AT&T Bell Laboratories 
DEC is a trademark of Digital Equipment Corporation 


Copyright © 1 984 AT&T Technologies 
All Rights Reserved 
Printed in U.S.A. 


AT&T 


DEC, PDP, UNIBUS, and MASSBUS are trademarks of Digital Equipment 
Corporation. 

HP is a trademark of Hewlett-Packard, Inc. 

DIABLO is a trademark of Xerox Corporation. 

TEKTRONIX is a registered trademark of Tektronix, Inc. 

Versatec is a registered trademark of Versatec Corporation. 

TELETYPE is a trademark of AT&T Teletype Corporation. 

3B and DOCUMENTER’S WORKBENCH are trademarks of AT&T 
Technologies. 

UNIX is a trademark of AT&T Bell Laboratories. 

This manual was set on an AUTOLOGIC, Inc. 

APS-5 phototypesetter driven by the TROFF 
formatter operating under the UNIX system. 


- 2 - 



INTRODUCTION 


This manual describes the programming features of the UNIX system. It provides nei- 
ther a general overview of the UNIX system nor details of the implementation of the 
system. 

Not all commands, features, and facilities described in this manual are available in 
every UNIX system. The entries not applicable for a particular hardware line will have 
an appropriate caveat stamped in the center of the mast of an entry. Also, programs or 
facilities being phased out will be marked as “Obsolescent” on the top of the entry. 
When in doubt, consult your system’s administrator. 

This manual is divided into four sections, some containing inter-filed sub-classes: 

2. System Calls. 

3. Subroutines: 

3C. C and Assembler Library Routines 
3S. Standard I/O Library Routines 
3M. Mathematical Library Routines 
3X. Miscellaneous Routines 
3F. FORTRAN Library Routines 

4. File Formats. 

5. Miscellaneous Facilities. 

Section 2 ( System Calls) describes the entries into the UNIX system kernel, including 
the C language interface. 

Section 3 ( Subroutines ) describes the available subroutines. Their binary versions 
reside in various system libraries in the directories /lib and /usr/lib. See intro (3) for 
descriptions of these libraries and the files in which they are stored. 

Section 4 {File Formats) documents the structure of particular kinds of files; for exam- 
ple, the format of the output of the link editor is given in a.outl 4). Excluded are files 
used by only one command (for example, the assembler’s intermediate files). In gen- 
eral, the C language struct declarations corresponding to these formats can be found in 
the directories /usr /include and /usr/include/sys. 

Section 5 ( Miscellaneous Facilities) contains a variety of things. Included are descrip- 
tions of character sets, macro packages, etc. 

Each section consists of a number of independent entries of a page or so each. The 
name of the entry appears in the upper corners of its pages. Entries within each section 
are alphabetized, with the exception of the introductory entry that begins each section 
(also section 3 is in alphabetical order by suffixes). Some entries may describe several 
routines, commands, etc. In such cases, the entry appears only once, alphabetized 
under its “major” name. 

All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its purpose. 

The SYNOPSIS part summarizes the use of the program being described. A few 
conventions are used, particularly in Section 2 {System Calls)-. 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and program 
names found elsewhere in the manual (they are underlined in the typed ver- 
sion of the entries). 

Square brackets [] around an argument prototype indicate that the argument 
is optional. When an argument prototype is given as “name” or “file”, it 
always refers to a file name. 
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Ellipses ... are used to show that the previous argument prototype may be 
repeated. 

A final convention is used by the commands themselves. An argument begin- 
ning with a minus — , plus +, or equal sign = is often taken to be some sort of 
flag argument, even if it appears in a position where a file name could appear. 
Therefore, it is unwise to have files whose names begin with — , +, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) of usage, where appropriate. 

The FILES part gives the file names that are built into the program. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be produced. 
Messages that are intended to be self-explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, the 
suggested fix is also described. 

A table of contents precedes Section 2. On each index line, the title of the entry to 
which that line refers is followed by the appropriate section number in parentheses. 
This is important because there is considerable duplication of names among the sec- 
tions, arising principally from commands that exist only to exercise a particular system 
call. 

On most systems, all entries are available on-line via the man( 1) command (see Sec- 
tion 1 of the UNIX System User Reference Manual) . 
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2. System Calls 

intro introduction to system calls and error numbers 

access determine accessibility of a file 

acct enable or disable process accounting 

alarm set a process alarm clock 

brk change data segment space allocation 

chdir change working directory 

chmod change mode of file 

chown change owner and group of a file 

chroot change root directory 

dose close a file descriptor 

creat create a new file or rewrite an existing one 

dup duplicate an open file descriptor 

exec execute a file 

exit terminate process 

fcntl file control 

f° r k create a new process 

getpid get process, process group, and parent process IDs 

getuid get real user, effective user, real group, and effective group IDs 

ioctl control device 

kill send a signal to a process or a group of processes 

link link to a file 

l see k move read/write file pointer 

maus multiple-access-user-space (shared memory) operations 

mknod make a directory, or a special or ordinary file 

mount mount a file system 

msgctl message control operations 

ms gg et get message queue 

msgop message operations 

nice change priority of a process 

°pen open for reading or writing 

P ause suspend process until signal 

pipe create an interprocess channel 

pl°ck lock process, text, or data in memory 

P r °fil execution time profile 

P tr ace process trace 

re ad read from file 

semctl semaphore control operations 

semget get set of semaphores 

semop semaphore operations 

setpgrp set process group ID 

setuid set user and group IDs 

shmctl shared memory control operations 

shmget get shared memory segment 

shmop shared memory operations 

signal specify what to do upon receipt of a signal 

st at get file status 

stime set time 

sync update super-block 

tjme get time 

times get process and child process times 

ulimit get and set user limits 

umask set and get file creation mask 

umount unmount a file system 

uname get name of current UNIX system 
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unlink remove directory entry 

ustat get file system statistics 

utime set file access and modification times 

wait wait for child process to stop or terminate 

write write on a file 

3. Subroutines 

intro introduction to subroutines and libraries 

a641 convert between long integer and base-64 ASCII string 

abort generate an IOT fault 

abort terminate Fortran program 

abs return integer absolute value 

abs Fortran absolute value 

acos Fortran arccosine intrinsic function 

aimag Fortran imaginary part of complex argument 

aint Fortran integer part intrinsic function 

asin Fortran arcsine intrinsic function 

assert verify program assertion 

atan Fortran arctangent intrinsic function 

atan2 Fortran arctangent intrinsic function 

bessel Bessel functions 

bool Fortran bitwise boolean functions 

bsearch binary search a sorted table 

clock report CPU time used 

conjg Fortran complex .conjugate intrinsic function 

translate characters 

cos Fortran cosine intrinsic function 

cosh Fortran hyperbolic cosine intrinsic function 

crypt generate DES encryption 

ctermid generate file name for terminal 

dime convert date and time to string 

ctype classify characters 

curses CRT screen handling and optimization package 

cuserid get character login name of the user 

dial establish an out-going terminal line connection 

dim positive difference intrinsic functions 

dprod double precision product intrinsic function 

drand48 generate uniformly distributed pseudo-random numbers 

ecvt convert floating-point number to string 

end last locations in program 

erf error function and complementary error function 

exp Fortran exponential intrinsic function 

exp exponential, logarithm, power, square root functions 

fclose close or flush a stream 

ferror stream status inquiries 

floor floor, ceiling, remainder, absolute value functions 

fopen open a stream 

fread binary input/output 

frexp manipulate parts of floating-point numbers 

fseek reposition a file pointer in a stream 

ftw walk a file tree 

ftype explicit Fortran type conversion 

gamma log gamma function 

getarg return Fortran command-line argument 

getc get character or word from a stream 

getcwd get path-name of current working directory 

getenv return value for environment name 
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S etenv return Fortran environment variable 

getgrent get group file entry 

getlogin get i 0 gj n name 

8 et0 Pt get option letter from argument vector 

getpass read a password 

8 et P w get name from UID 

getpwent get password file entry 

8 ets get a string from a stream 

8 etut access utmp file entry 

hsearch manage hash search tables 

h yP ot Euclidean distance function 

j ar 8 c iargc 

' n d ex return location of Fortran substring 

13tol convert between 3-byte integers and long integers 

Idahread read the archive header of a member of an archive file 

ldclose close a common object file 

ldfhread read the file header of a common object file 

ldgetname .... retrieve symbol name for common object file symbol table entry 

ldlread manipulate line number entries of a common object file function 

ldlseek seek to line number entries of a section of a common object file 

ldohseek seek to the optional file header of a common object file 

ldopen open a common object file for reading 

ldrseek seek to relocation entries of a section of a common object file 

ldshread read an indexed/named section header of a common object file 

ldsseek seek to an indexed/named section of a common object file 

ldtbindex . . . compute the index of a symbol table entry of a common object file 

ldtbread read an indexed symbol table entry of a common object file 

ldtbseek seek to the symbol table of a common object file 

l en return length of Fortran string 

*°8 Fortran natural logarithm intrinsic function 

Fortran common logarithm intrinsic function 

logname return login name of user 

lsearch linear search and update 

ma " oc main memory allocator 

ma M° c fast main memory allocator 

matherr error-handling function 

max Fortran maximum-value functions 

rnc l° c * c return Fortran time accounting 

memory memory operations 

mln Fortran minimum-value functions 

mktemp make a unique file name 

mo d Fortran remaindering intrinsic functions 

monitor prepare execution profile 

n *‘ st get entries from name list 

P error system error messages 

Pi 01 graphics interface subroutines 

initiate pipe to/from a process 

P r ' nt f print formatted output 

P utc put character or word on a stream 

P utenv change or add value to environment 

putpwent write password file entry 

P uts put a string on a stream 

1 sort quicker sort 

ran d simple random-number generator 

rar *d random number generator 

regcmp compile and execute regular expression 

roun d Fortran nearest integer functions 
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scanf convert formatted input 

setbuf assign buffering to a stream 

setjmp non-local goto 

sign Fortran transfer-of-sign intrinsic function 

signal specify Fortran action on receipt of a system signal 

sin Fortran sine intrinsic function 

sinh Fortran hyperbolic sine intrinsic function 

sinh hyperbolic functions 

sleep suspend execution for interval 

sputl access long integer data in a machine-independent fashion. 

sqrt Fortran square root intrinsic function 

ssignal software signals 

stdio standard buffered input/output package 

stdipc standard interprocess communication package 

strcmp string comparision intrinsic functions 

string string operations 

strtod convert string to double-precision number 

strtol convert string to integer 

swab swap bytes 

system issue a shell command from Fortran 

system issue a shell command 

tan Fortran tangent intrinsic function 

tanh Fortran hyperbolic tangent intrinsic function 

tmpfile create a temporary file 

tmpnam create a name for a temporary file 

trig trigonometric functions 

tsearch manage binary search trees 

ttyname find name of a terminal 

ttyslot find the slot in the utmp file of the current user 

ungetc push character back into input stream 

vprintf print formatted output of a varargs argument list 

vprintf print formatted output of a varargs argument list 

4. File Formats 

intro introduction to file formats 

a.out common assembler and link editor output 

a.out.pdp PDP-11 assembler and link editor output 

acct per-process accounting file format 

common archive file format 

ar.pdp archive file format 

checklist list of file systems processed by fsck 

core . format of core image file 

cpio format of cpio archive 

dir format of directories 

errfile error-log file format 

filehdr file header for common object files 

fs format of system volume 

fspec format specification in text files 

gettydefs speed and terminal settings used by getty 

gps graphical primitive string, format of graphical files 

group group file 

inittab script for the init process 

inode format of an i-node 

issue issue identification file 

ldfcn common object file access routines 

linenum line number entries in a common object file 

master. dec master device information table 
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plot 
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profile 
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sccsfile 
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syms 

term 

terminfo 

utmp 

5. Miscellaneous Facilities 
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ascii 

environ 

fcntl 

math 

prof 

regexp 

stat 

term 

types 

values 
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mounted file system table 

password file 

graphics interface 

file format for card images 

. . . setting up an environment at login time 
relocation information for a common object file 

format of SCCS file 

. • . . section header for a common object file 
. . . common object file symbol table format 

format of compiled term file. 

terminal capability data base 

utmp and wtmp entry formats 


introduction to miscellany 

map of ASCII character set 

user environment 

file control options 

math functions and constants 

profile within a function 

regular expression compile and match routines 

data returned by stat system call 

conventional names for terminals 

primitive system data types 

machine-dependent values 

handle variable argument list 
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70boot: 1 1/70 bootstrap procedures 70boot(8) 

archiver, hpio: HP 2645 A terminal tape file hpio(l) 

300: DASI 300 and 300s terminals 300(1) 

terminals. 300: DASI 300 and 300s 300(1) 

300: DASI 300 and 300s terminals 300(1) 

13tol: convert between 3-byte integers and long/ 13tol(3C) 

comparison. diff3: 3-way differential file diff3(l) 

TEKTRONIX 4014 terminal. 4014: paginator for the 4014(1) 

paginator for the TEKTRONIX 4014 terminal. 4014: 4014(1) 

of the DASI 450 terminal. 450: handle special functions 450(1) 

special functions of the DASI 450 terminal. 450: handle 450(1) 

procedures. 70boot: 1 1/70 bootstrap 70boot(8) 

operations. 7 50ops: VAX- 1 1/750 console 750ops(8) 

177: Fortran 77 compiler f77(l) 

operations. 780ops: VAX- 1 1/780 console 780ops(8) 

integer and base-64 ASCII/ a641: convert between long a641(3C) 

abort: generate an IOT fault abort(3C) 

program, abort: terminate Fortran abort(3F) 

abs: Fortran absolute value abs(3F) 

value, abs: return integer absolute abs(3C) 

adb: absolute debugger adb(l) 

abs: return integer absolute value abs(3C) 

abs: Fortran absolute value abs(3F) 

/floor, ceiling, remainder, absolute value functions floor(3M) 

requests, accept: allow/prevent LP accept(lM) 

of a file, touch: update access and modification times touch(l) 

utime: set file access and modification times utime(2) 

accessibility of a file, access: determine access(2) 

commands, graphics: access graphical and numerical .... graphics(lG) 

machine-independent/ sputl: access long integer data in a sputl(3X) 

sadp: disk access profiler sadp(lM) 

ldfcn: common object file access routines ldfcn(4) 

copy file systems for optimal access time, dcopy: dcopy(lM) 

getutent: access utmp file entry getut(3C) 

access: determine accessibility of a file access(2) 

acctdisk: overview of accounting acct(lM) 

enable or disable process accounting, acct: acct(2) 

acctcon 1 : connect-time accounting acctcon(lM) 

acctprcl: process accounting acctprc(lM) 

shell procedures for accounting, chargefee: acctsh(lM) 

diskusg: generate disk accounting data by user ID diskusg(lM) 

acct: per-process accounting file format acct(4) 

search and print process accounting file(s). acctcom: acctcom(l) 

acctmerg: merge or add total accounting files acctmerg(lM) 

mclock: return Fortran time accounting mclock(3F) 

summary from per-process accounting records, /command .... acctcms(lM) 

fwtmp: manipulate connect accounting records fwtmp(lM) 

runacct: run daily accounting runacct(lM) 

process accounting, acct: enable or disable acct(2) 

file format, acct: per-process accounting acct(4) 

per-process accounting/ acctcms: command summary from . . . acctcms(lM) 

process accounting file (s). acctcom: search and print acctcom(l) 

accounting, acctcon 1: connect-time acctcon (1M) 

accounting acctdisk: overview of acct(lM) 

accounting files, acctmerg: merge or add total acctmerg(lM) 

acctprcl: process accounting acctprc(lM) 

intrinsic function, acos: Fortran arccosine acos(3F) 

killall: kill all active processes killall(lM) 

sag: system activity graph sag(lG) 

sal: system activity report package sar(lM) 

sar: system activity reporter sar(l) 
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current SCCS file editing activity, sact: print sact(l) 

report process data and system activity, /time a command; timex(l) 

interface, acu: Automatic Call Unit (ACU) . . . acu(7) 

acu: Automatic Call Unit (ACU) interface acu(7) 

adb: absolute debugger adb(l) 

acctmerg: merge or add total accounting files acctmerg(lM) 

putenv: change or add value to environment putenv(3C) 

SCCS files, admin: create and administer admin(l) 

admin: create and administer SCCS files admin(l) 

of complex argument, aimag: Fortran imaginary part .... aimag(3F) 

intrinsic function, aint: Fortran integer part aint(3F) 

alarm: set a process alarm clock alarm (2) 

clock, alarm: set a process alarm alarm(2) 

brk: change data segment space allocation brk(2) 

malloc: main memory allocator malloc(3C) 

malloc: fast main memory allocator malloc(3X) 

accept: allow/prevent LP requests accept(lM) 

boolean functions, and, or, xor, not: Fortran bool(3F) 

disk packs, format: format and/or check RP06 and RM05 .... format(lM) 

sort: sort and/or merge files sort(l) 

send: gather files and/or submit RJE jobs: send(lC) 

functions, anint: Fortran nearest integer round (3 F) 

link editor output, a.out: common assembler and a.out(4) 

mkboot: convert a.out file to boot image mkboot(lM) 

link editor output, a.out: PDP-1 1 assembler and a.out. pdp(4) 

maintainer. ar: archive and library ar.pdp(l) 

maintainer for portable/ ar: archive and library ar(l) 

ar: archive file format ar.pdp(4) 

format, ar: common archive file ar(4) 

language.be: arbitrary-precision arithmetic bc(l) 

acos: Fortran arccosine intrinsic function acos(3F) 

maintainer. ar: archive and library ar.pdp(l) 

for portable archives, ar: archive and library maintainer .... ar(l) 

cpio: format of cpio archive cpio(4) 

ar: common archive file format ar(4) 

ar: archive file format ar.pdp(4) 

common format, arev: convert archive files from PDP-1 1 to arcv.pdp(l) 

ldahread: read the archive header ldahread(3X) 

HP 2645A terminal tape file archiver, hpio: hpio(l) 

tar: tape file archiver tar(l) 

maintainer for portable archives, /archive and library ar(l) 

cpio: copy file archives in and out cpio(l) 

asin: Fortran arcsine intrinsic function asin(3F) 

atan2: Fortran arctangent intrinsic function atan2(3F) 

atan: Fortran arctangent intrinsic function atan(3F) 

from PDP-1 1 to common format, arev: convert archive files arcv.pdp(l) 

imaginary part of complex argument, aimag: Fortran aimag(3F) 

return Fortran command-line argument, getarg: getarg(3F) 

varargs: handle variable argument list varargs(5) 

formatted output of a varargs argument list, vprintf: print vprintf(3S) 

formatted output of a varargs argument list, vprintf: print vprintf(3X) 

command, xargs: construct argument list(s) and execute xargs(l) 

getopt: get option letter from argument vector getopt(3C) 

expr: evaluate arguments as an expression expr(l) 

echo: echo arguments echo(l) 

be: arbitrary-precision arithmetic language bc(l) 

number facts, arithmetic: provide drill in arithmetic(6) 

expr: evaluate arguments as an expression expr(l) 

as: assembler for PDP-1 1 as.pdp(l) 

as: common assembler as(l) 

characters, asa: interpret ASA carriage control asa(l) 

control characters, asa: interpret ASA carriage asa(l) 

ascii: map of ASCII character set ascii (5) 

set. ascii: map of ASCII character .... ascii (5) 
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long integer and base-64 ASCII string, /convert between .... a641(3C) 

intrinsic function, asin: Fortran arcsine asin(3F) 

help: ask for help help(l) 

output, a.out: common assembler and link editor a.out(4) 

output, a.out: PDP-1 1 assembler and link editor a.out. pdp(4) 

as: common assembler as(l) 

as: assembler for PDP-1 1 as.pdp(l) 

KMCllBkasb: assembler/ un-assembler for the .... kasb(l) 

assertion, assert: verify program assert (3X) 

assert: verify program assertion assert(3X) 

setbuf: assign buffering to a stream setbuf(3S) 

qasurvey: Quality Assurance Survey qasurvey(lM) 

kl: KL-1 1 or DL-1 1 asynchronous interface kl.pdp(7) 

/DZ-1 1, DZ-1 1/KMC-l IB, DH-1 1 asynchronous multiplexers dz(7) 

intrinsic function, atan: Fortran arctangent atan(3F) 

intrinsic function. atan2: Fortran arctangent atan2(3F) 

interface, acu: Automatic Call Unit (ACU) acu(7) 

wait: await completion of process wait(l) 

processing language, awk: pattern scanning and awk(l) 

ungetc: push character back into input stream ungetc(3S) 

back: the game of backgammon. . . . back (6) 

back: the game of backgammon back(6) 

UNIX system file system backup, /daily/weekly filesave(lM) 

fine: fast incremental backup fined M) 

free: recover files from a backup tape freed M) 

print, initialize, update bad information bdblk: bdblk(lM) 

banner: make posters bannerd) 

terminal capability data base, terminfo: terminfo(4) 

between long integer and base-64 ASCII string, /convert .... a641(3C) 

portions of path names, basename, dirname: deliver basename(l) 

arithmetic language, be: arbitrary-precision bed) 

bcopy: interactive block copy bcopyd M) 

update bad information bdblk: print, initialize bdblk (1M) 

bdiff: big diff bdiff(l) 

cb: C program beautifier cb(l) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

bfs: big file scanner bfs(l) 

cpset: install object files in binary directories cpset(lM) 

fread: binary input/output fread(3S) 

bsearch: binary search a sorted table bsearch(3C) 

tsearch: manage binary search trees tsearch(3C) 

remove symbols and relocation bits, strip: strip.pdp(l) 

bj: the game of black jack bj (6) 

bj: the game of blackjack bj(6) 

bcopy: interactive block copy bcopyd M) 

sum: print checksum and block count of a file sum(l) 

sync: update the super block sync(l) 

df: report number of free disk blocks df(lM) 

and, or, xor, not: Fortran boolean functions bool (3 F) 

mkboot: convert a.out file to boot image mkboot(lM) 

UNIX system startup and boot procedures, unixboot: unixboot(8) 

romboot: special ROM bootstrap loaders romboot(8) 

70boot: 11/70 bootstrap procedures 70boot(8) 

tapeboot: magnetic tape bootstrap program tapeboot(8) 

diskboot: disk bootstrap programs diskboot(8) 

shell scripts, bre: system initialization brc(lM) 

allocation, brk: change data segment space .... brk(2) 

modest-sized programs, bs: a compiler/interpreter for bs(l) 

sorted table, bsearch: binary search a bsearch(3C) 

stdio: standard buffered input/output package stdio(3S) 

setbuf: assign buffering to a stream setbuf(3S) 

mknod: build special file mknod(lM) 

dmc: communications link with built-in DDCMP protocol dmc(7) 

swab: swap bytes swab(3C) 
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cc: C compiler cc(l) 

programs, see: C compiler for stand-alone scc(l) 

cflow. generate C flow graph cflow (1) 

epp: the C language preprocessor cpp(l) 

cb: C program beautifier cb(l) 

lint: a C program checker lint(l) 

cxref: generate C program cross-reference cxref(l) 

ctrace: C program debugger ctrace(l) 

cal: print calendar cal(l) 

dc: desk calculator dc(l) 

cal: print calendar cal(l) 

calendar: reminder service. ...... calendar(l) 

cu: call another UNIX system cu(lC) 

data returned by stat system call, stat: stat(5) 

acu: Automatic Call Unit (ACU) interface acu(7) 

intro: introduction to system calls and error numbers intro(2) 

link and unlink system calls, link: exercise link(lM) 

to an LP line printer. Ip, cancel: send/cancel requests lpO) 

terminfo: terminal capability data base terminfo(4) 

pnch: file format for card images pnch(4) 

asa: interpret ASA carriage control characters asa(l) 

files, cat: concatenate and print cat(l) 

cb: C program beautifier cb(l) 

cc: C compiler cc(l) 

cd: change working directory cd(l) 

commentary of an SCCS delta, ede: change the delta 

value/ floor: floor, ceiling, remainder, absolute floorUMl 

cflow: generate C flow graph cflow(l) 

delta: make a delta (change) to an SCCS file delta(l) 

pipe: create an interprocess channel. pipe 

stream, ungetc: push character back into input ungetc(3S) 

user, cuserid: get character login name of the cuserid(3S) 

stream, getc: get character or word from a getc(3S) 

putc: put character or word on a stream putc(3S) 

ascii: map of ASCII character set ascii (5) 

interpret ASA carriage control characters, asa: asa ' p 

toupper: translate characters 

isalpha: classify characters ctype(3C) 

tr: translate characters tr (U 

for accounting, chargefee: shell procedures acctsh(lM) 

directory, chdir: change working chdir(2) 

fsck: file system consistency check fsck(lM) 

packs, format: format and/or check RP06 and RM05 disk format(lM) 

checking procedure, checkall: faster file system checkall(lM) 

lint: a C program checker lint(l) 

pwck: password/group file checkers pWC *l xxt 

checkall: faster file system checking procedure checkall 1(1 M) 

copy file systems with label checking, volcopy: volcopy(lM) 

systems processed by fsck. checklist: list of file checklist (4) 

file, sum: print checksum and block count of a .... sum(l) 

chess: the game of chess chess (6) 

chess: the game of chess chess(6) 

times: get process and child process times times (2) 

terminate, wait: wait for child process to stop or wait (2) 

chmod: change mode chmod(l) 

chmod: change mode of file chmod (2) 

of a file, chown: change owner and group .... chown(2) 

chown: change owner or group chown(l) 

chroot: change root directory chroot(2) 

for a command, chroot: change root directory chroot(lM) 

isalpha: classify characters ctype(3C) 

uuclean: uucp spool directory clean-up uuclean(lM) 

clri: clear i-node clnUM) 

alarm: set a process alarm clock alarm(2) 
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cron: clock daemon cron(lM) 

clock: report CPU time used clock(3C) 

ldclose: close a common object file ldclose(3X) 

close: close a file descriptor close(2) 

descriptor, close: close a file close(2) 

fclose: close or flush a stream fclose(3S) 

clri: clear i-node clri(lM) 

cmp: compare two files cmp(l) 

line-feeds, col: filter reverse col(l) 

comb: combine SCCS deltas. . .... comb(l) 

comb: combine SCCS deltas comb(l) 

common to two sorted files, comm: select or reject lines comm(l) 

nice: run a command at low priority nice(l) 

change root directory for a command, chroot: chroot(lM) 

env: set environment for command execution env(l) 

uux: UNIX-to-UNIX system command execution uux(lC) 

system: issue a shell command from Fortran system(3F) 

quits, nohup: run a command immune to hangups and . . . nohup(l) 

net: execute a command on the PCL network net(lC) 

getopt: parse command options getopt(l) 

/shell, the standard/restricted command programming language. . . . sh(l) 

and system/ timex: time a command; report process data timex(l) 

per-process/ acctcms: command summary from acctcms(lM) 

system: issue a shell command system(3S) 

test: condition evaluation command test(l) 

time: time a command time(l) 

argument list(s) and execute command, xargs: construct xargs(l) 

getarg: return Fortran command-line argument getarg(3F) 

at: execute commands at a later time at(l) 

access graphical and numerical commands, graphics: graphics(lG) 

install: install commands install (1M) 

intro: introduction to commands intro(l) 

introduction to maintenance commands intro: intro(lM) 

how to remake the system and commands, mk: mk(8) 

network useful with graphical commands, stat: statistical stat(lG) 

ede: change the delta commentary of an SCCS delta cdc(l) 

ar: common archive file format ar(4) 

editor output, a.out: common assembler and link a.out(4) 

as: common assembler as(l) 

archive files from PDP-1 1 to common format, arev: convert .... arcv.pdp(l) 

object/archive files to common formats, /convert convert(l) 

function. loglO: Fortran common logarithm intrinsic log 10(3F) 

routines, ldfcn: common object file access ldfcn(4) 

reading, ldopen: open a common object file for ldopen(3X) 

ldclose: close a common object file ldclose(3X) 

read the file header of a common object file, ldfhread: ldfhread(3X) 

seek to the symbol table of a common object file, ldtbseek: ldtbseek(3X) 

line number entries in a common object file. Iinenum: linenum(4) 

nm: print name list of common object file nm(l) 

relocation information for a common object file, reloc: reloc(4) 

scnhdr: section header for a common object file scnhdr(4) 

table format, syms: common object file symbol syms(4) 

filehdr: file header for common object files filehdr(4) 

Id: link editor for common object files ld(l) 

size: print section sizes of common object files sized ) 

comm: select or reject lines common to two sorted files comm(l) 

ipcs: report inter-process communication facilities/ ipcs(l) 

ftok: standard interprocess communication package stdipc(3C) 

pci: parallel communications link interface pci (7) 

built-in DDCMP protocol, dmc: communications link with dmc(7) 

diff: differential file comparator diff(l) 

cmp: compare two files cmp(l) 

SCCS file, sccsdiff: compare two versions of an sccsdiff(l) 

functions, lge: string comparision intrinsic strcmp(3F) 
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diff3: 3-way differential file 
dircmp: directory 
expression, regcmp: 
regexp: regular expression 
regcmp: regular expression 
term: format of 
cc: C 
f77: Fortran 77 
programs, see: C 
protocol machine, vpmc: 

tic: terminfo 
yacc: yet another 
modest-sized programs, bs: a 
erf: error function and 
wait: await 
Fortran imaginary part of 
function, conjg: Fortran 
pack: 

table entry of a/ ldtbindex: 

cat: 

test: 

system. 

program, vcf: VAX-11/780 
config: 
system, lpadmin: 
conjugate intrinsic function, 
conjg: Fortran complex 
fwtmp: manipulate 
KMC11-B dmkset: 
an out-going terminal line 
vpmset: 
acctcon 1 : 
fsck: file system 
vlx: VAX-11/780 LSI 
7 5 Oops: VAX-11/750 
780ops: VAX-11/780 
math: math functions and 
mkfs: 

execute command, xargs: 

Is: list 

toe: graphical table of 
esplit: 

asa: interpret ASA carriage 
ioctl: 
fcntl: file 
init: process 
dmk: DM 11 -BA modem 
msgctl: message 
semctl: semaphore 
shmctl: shared memory 
fcntl: file 

uucp status inquiry and job 
vc: version 
interface, tty: 
terminals, term: 
int: explicit Fortran type 
units: 
dd: 

image, mkboot: 
PDP-11 to common/ arev: 

integers and long/ 13tol: 
and base-64 ASCII/ a641: 
object/archive files to/ 
string, dime: 


comparison 

comparison 

compile and execute regular 
compile and match routines. 

compile 

compiled term file 

compiler 

compiler 

compiler for stand-alone . 
compiler for the virtual 

compiler 

compiler-compiler. . . . 
compiler/interpreter for 
complementary error function 
completion of process. . . 
complex argument, aimag: 
complex conjugate intrinsic 
compress and expand files, 
compute the index of a symbo 
concatenate and print files, 
condition evaluation commanc 
config: configure a UNIX 
configuration verification . 
configure a UNIX system, 
configure the LP spooling 
conjg: Fortran complex 
conjugate intrinsic function, 
connect accounting records, 
connect DM1 1-BA modems 
connection, dial: establish 
connect/load VPM drivers 
connect-time accounting. . 
consistency check .... 
console floppy interface, 
console operations. . . . 
console operations. . . . 

constants 

construct a file system. . . 
construct argument list(s) ant 
contents of directory. . . 

contents routines 

context split 

control characters 

control device 

control 

control initialization. . . . 
control multiplexor. . . . 

control operations 

control operations 

control operations 

control options 

control, uustat: 

control 

controlling terminal . . . 
conventional names for . . 

conversion 

conversion program. . . . 
convert and copy a file, 
convert a.out file to boot . 
convert archive files from . 
convert between 3-byte . . 
convert between long intege 

convert: convert 

convert date and time to 


diff3(l) 

dircmp(l) 

regcmp(3X) 

regexp(5) 

regcmp(l) 

term (4) 

cc(l) 

f77 (1) 

scc(l) 

vpmc. deed M) 

tic(lM) 

yacc(l) 

bs(l) 

erf(3M) 

wait(l) 

aimag(3F) 

conjg(3F) 

pack(l) 

ldtbindex(3X) 

cat(l) 

test(l) 

config.dc(lM) 

vcf(lM) 

config.dc(lM) 

lpadmin(lM) 

conjg(3F) 

conjg(3F) 

fwtmp(lM) 

dmkset (1M) 

dial(3C) 

vpmset(lM) 

acctcon (1M) 

. fsck(lM) 

, vlx(lM) 

. 750ops(8) 

. 780ops(8) 

. math (5) 

. mkfs(lM) 

. xargs(l) 

. ls(l) 

. toc(lG) 

. esplit (l) 

. asa(l) 

. ioctl (2) 

. fcntl(2) 

. init(lM) 

. dmk(7) 

. msgctl (2) 

. semctl (2) 

. shmctl (2) 

. fcntl (5) 

. uustat(lC) 

. vc(l) 

. tty (7) 

. term (5) 

. ftype(3F) 

. units(l) 

. dd(l) 

. mkboot (1M) 
. arcv.pdp(l) 

. 13tol(3C) 

. a641(3C) 

. convert (l) 

. ctime(3C) 


- 6 - 



Permuted Index 


and VAX-11/780 systems, fscv: convert files between PDP-1 1 fscv.vax(lM) 

to string, ecvt: convert floating-point number ecvt(3C) 

scanf: convert formatted input scanf(3S) 

to common formats, convert: convert object/archive files convert(l) 

double-precision/ strtod: convert string to strtod(3C) 

strtol: convert string to integer strtol(3C) 

dd: convert and copy a file dd(l) 

bcopy: interactive block copy bcopy(lM) 

cpio: copy file archives in and out cpio(l) 

access time, dcopy: copy file systems for optimal dcopy(lM) 

checking, volcopy: copy file systems with label volcopy(lM) 

cp, In, mv: copy, link or move files cp(l) 

UNIX system to UNIX system copy, uucp: uucp(lC) 

UNIX-to-UNIX system file copy, uuto: public uuto(lC) 

file, core: format of core image core (4) 

core: format of core image file core(4) 

mem: core memory mem (7) 

function, cos: Fortran cosine intrinsic cos(3F) 

cosine intrinsic function, cosh: Fortran hyperbolic cosh(3F) 

cos: Fortran cosine intrinsic function cos(3F) 

cosh: Fortran hyperbolic cosine intrinsic function cosh(3F) 

sum: print checksum and block count of a file sum(l) 

wc: word count wc(l) 

files, cp, In, mv: copy, link or move cp(l) 

cpio: format of cpio archive cpio(4) 

and out. cpio: copy file archives in cpio(l) 

cpio: format of cpio archive cpio(4) 

preprocessor, cpp: the C language cpp(l) 

binary directories, cpset: install object files in cpset(lM) 

clock: report CPU time used clock(3C) 

craps: the game of craps craps(6) 

craps: the game of craps craps (6) 

crash: examine system images crash (1M) 

system crashes, crash: what to do when the crash.dec(8) 

what to do when the system crashes, crash: crash.dec(8) 

rewrite an existing one. creat: create a new file or creat(2) 

file, tmpnam: create a name for a temporary .... tmpnam(3S) 

an existing one. creat: create a new file or rewrite creat (2) 

fork: create a new process fork (2) 

tmpfile: create a temporary file tmpfile(3S) 

channel, pipe: create an interprocess pipe(2) 

files, admin: create and administer SCCS admin(l) 

umask: set and get file creation mask umask(2) 

cron: clock daemon cron(lM) 

crontab: user crontab file crontab(l) 

crontab: user crontab file crontab(l) 

cxref: generate C program cross-reference cxref(l) 

optimization package, curses: CRT screen handling and curses(3X) 

crypt: encode/decode crypt(l) 

encryption, crypt: generate DES crypt(3C) 

csplit: context split csplit(l) 

terminal, ct: spawn getty to a remote ct(lC) 

for terminal, ctermid: generate file name ctermid(3S) 

to string, ctime: convert date and time ctime(3C) 

ctrace: C program debugger ctrace(l) 

cu: call another UNIX system cu(lC) 

activity, sact: print current SCCS file editing sact(l) 

uname: print name of current UNIX system uname(l) 

uname: get name of current UNIX system uname(2) 

slot in the utmp file of the current user, /find the ttyslot(3C) 

getcwd: get path-name of current working directory getcwd(3C) 

and optimization package, curses: CRT screen handling curses (3X) 

spline: interpolate smooth curve spline (1G) 

name of the user, cuserid: get character login cuserid(3S) 
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of each line of a file, cut: cut out selected fields cut(l) 

each line of a file, cut: cut out selected fields of cut(l) 

cross-reference, cxref: generate C program cxref(l) 

cron: clock daemon cron(lM) 

errdemon: error-logging daemon. . . . errdemon(lM) 

terminate the error-logging daemon, errstop: errstop(lM) 

runacct: run daily accounting runacct(lM) 

system backup, filesave: daily/weekly UNIX system file .... filesave(lM) 

300: DASI 300 and 300s terminals 300(1) 

special functions of the DASI 450 terminal, /handle 450(1) 

/time a command; report process data and system activity timex(l) 

terminfo: terminal capability database terminfo(4) 

generate disk accounting data by user ID. diskusg: diskusg(lM) 

sputl: access long integer data in a machine-independent/ .... sputl(3X) 

plock: lock process, text, or data in memory plock(2) 

prof: display profile data prof(l) 

call, stat: data returned by stat system stat(5) 

brk: change data segment space allocation brk(2) 

types: primitive system data types types(5) 

join: relational database operator join(l) 

tput: query terminfo database tput(l) 

dime: convert date and time to string ctime(3C) 

date: print and set the date date(l) 

date: print and set the date date(l) 

dc: desk calculator dc(l) 

optimal access time, dcopy: copy file systems for dcopy(lM) 

dd: convert and copy a file dd(l) 

/link with built-in DDCMP protocol dmc(7) 

adb: absolute debugger • adb(l) 

ctrace: C program debugger ctrace(l) 

fsdb: file system debugger fsdb(lM) 

sdb: symbolic debugger sdb(l) 

sysdef: system definition sysdef(lM) 

names, basename, dirname: deliver portions of path basename(l) 

file, tail: deliver the last part of a . tail(l) 

delta commentary of an SCCS delta, cdc: change the cdc(l) 

file, delta: make a delta (change) to an SCCS delta ( 1 ) 

delta, cdc: change the delta commentary of an SCCS .... cdc(l) 

rmdel: remove a delta from an SCCS file rmdel(l) 

to an SCCS file, delta: make a delta (change) delta(l) 

comb: combine SCCS deltas comb(l) 

mesg: permit or deny messages mesg(l) 

crypt: generate DES encryption crypt(3C) 

close: close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

dc: desk calculator dc(l) 

file, access: determine accessibility of a access(2) 

file: determine file type filed ) 

master: master device information table master.dec(4) 

ioctl: control device ioctl (2) 

devnm: device name devnm(lM) 

hpd: graphical device routines and filters gdev(lG) 

devnm: device name devnm(lM) 

blocks, df: report number of free disk df(lM) 

dz: DZ-11, DZ-1 1/KMC-l IB, DH-11 asynchronous/ dz(7) 

terminal line connection, dial: establish an out-going dial(3C) 

ratfor: rational Fortran dialect ratfor(l) 

bdiff: big diflf. bdiff(l) 

comparator, diflf: differential file diff(l) 

comparison. diff3: 3-way differential file diff3(l) 

functions, dim: positive difference intrinsic dim(3F) 

sdiff: side-by-side difference program sdiff(l) 

diffmk: mark differences between files diffmk(l) 

diff: differential file comparator diff(l) 
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diff3: 3-way differential file comparison difT3 (1 ) 

between files, diffmk: mark differences diffmk(l) 

intrinsic functions, dim: positive difference dim(3F) 

dir: format of directories dir(4) 

dircmp: directory comparison dircmp(l) 

install object files in binary directories, cpset: cpset(lM) 

dir: format of directories dir (4) 

rm: remove files or directories rm(l) 

cd: change working directory cd(l) 

chdir: change working directory chdir (2) 

chroot: change root directory chroot(2) 

uuclean: uucp spool directory clean-up uuclean(lM) 

dircmp: directory comparison dircmp(l) 

unlink: remove directory entry unlink(2) 

chroot: change root directory for a command chroot (1M) 

path-name of current working directory, getcwd: get getcwd(3C) 

Is: list contents of directory ls(l) 

mkdir: make a directory mkdir(l) 

mvdir: move a directory mvdir(lM) 

pwd: working directory name pwd(l) 

ordinary file, mknod: make a directory, or a special or mknod(2) 

path names, basename, dirname: deliver portions of basename(l) 

acct: enable or disable process accounting acct(2) 

type, modes, speed, and line discipline, /set terminal getty(lM) 

sadp: disk access profiler sadp(lM) 

ID. diskusg: generate disk accounting data by user diskusg(lM) 

df: report number of free disk blocks df(lM) 

diskboot: disk bootstrap programs diskboot(8) 

RH1 1/RJS03-RJS04 fixed-head disk file, hs: hs.pdp(7) 

rf: RF1 1/RSI 1 fixed-head disk file rf.pdp(7) 

hm: RM05 moving-head disk hm(7) 

moving-head disk. /RP04/RP05/RP06 hp(7) 

mil 1: ML11 solid-state disk mlll.pdp(7) 

and/or check RP06 and RM05 disk packs, format: format format(lM) 

rk: RK-1 1/RK03 or RK05 disk rk pdp(7) 

rl: RL-1 1/RL01 disk rl(7) 

rm80: RM80 moving-head disk rm80(7) 

medium moving-head disk. /RP07 non-removable rp07(7) 

rp: RP-1 1/RP03 moving-head disk rp.pdp(7) 

du: summarize disk usage du(l) 

programs, diskboot: disk bootstrap diskboot(8) 

general driver for moving-head disks, gd: gd(7) 

accounting data by user ID. diskusg: generate disk diskusg(lM) 

mount: mount and dismount file system mount(lM) 

prof: display profile data prof(l) 

hypot: Euclidean distance function hypot(3M) 

drand48: generate uniformly distributed pseudo-random/ drand48(3C) 

kl:KL-llor DL-1 1 asynchronous interface kl.pdp(7) 

multiplexor, dmk: DM1 1 -BA modem control dmk(7) 

dmkset: connect DM1 1 -BA modems to KMC 1 1-B . . . dmkset(lM) 

built-in DDCMP protocol, dmc: communications link with .... dmc(7) 

multiplexor, dmk: DM1 1 -BA modem control .... dmk(7) 

toKMCll-B dmkset: connect DM1 1 -BA modems . . dmkset(lM) 

whodo: who is doing what whodo(lM) 

intrinsic function, dprod: double precision product dprod(3F) 

strtod: convert string to double-precision number strtod(3C) 

product intrinsic function, dprod: double precision dprod(3F) 

reversi: a game of dramatic reversals reversi(6) 

distributed pseudo-random/ drand48: generate uniformly drand48(3C) 

graph: draw a graph graph (1G) 

arithmetic: provide drill in number facts arithmetic^) 

gd: general driver for moving-head disks gd(7) 

gt: general driver for tape drives gt(7) 

sxt: pseudo-device driver sxt(7) 
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trace: event-tracing driver trace (7) 

vpmset: connect/load VPM drivers vpmset(lM) 

gt: general driver for tape drives gt(7) 

interface, du: DU-1 1 synchronous line du.pdp(7) 

du: summarize disk usage du(l) 

interface, du: DU- 11 synchronous line du.pdp(7) 

an object file, dump: dump selected parts of dump(l) 

extract error records from dump, errdead: errdead(lM) 

od: octal dump od(l) 

object file, dump: dump selected parts of an dump(l) 

descriptor, dup: duplicate an open file dup(2) 

descriptor, dup: duplicate an open file dup(2) 

DH-11 asynchronous/ dz: DZ-11, DZ-1 1/KMC-l IB, .... dz(7) 

asynchronous/ dz: DZ-11, DZ-1 1/KMC-l IB, DH-11 . . dz(7) 

asynchronous/ dz: DZ-11, DZ-1 1/KMC-l IB, DH-11 dz(7) 

echo: echo arguments echo(l) 

echo: echo arguments echo(l) 

number to string, ecvt: convert floating-point ecvt(3C) 

ed, red: text editor ed (1 ) 

edit: text editor edit(l) 

sact: print current SCCS file editing activity sact(l) 

ed, red: text editor ed(l) 

edit: text editor edit(l) 

ex: text editor ex(l) 

files. Id: link editor for common object Id ( 1 ) 

ged: graphical editor ged(lG) 

Id: link editor ld.pdp(l) 

common assembler and link editor output, a.out: a.out(4) 

PDP-1 1 assembler and link editor output, a.out: a.out. pdp(4) 

sed: stream editor sed(l) 

vi: screen-oriented editor vi(l) 

Language, efl: Extended Fortran efl(l) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

printers, enable: enable/disable LP enable(l) 

accounting, acct: enable or disable process acct(2) 

enable: enable/disable LP printers enable(l) 

crypt: encode/decode crypt(l) 

crypt: generate DES encryption crypt(3C) 

makekey: generate encryption key makekey(l) 

program, end: last locations in end(3C) 

trenter: enter a trouble report trenter(l) 

nlist: get entries from name list nlist(3C) 

file, linenum: line number entries in a common object linenum(4) 

man: print entries in this manual man(l) 

/manipulate line number entries of a file function ldlread(3X) 

ldlseek: seek to line number entries of a section of a / ldlseek(3X) 

ldrseek: seek to relocation entries of a section of a/ ldrseek(3X) 

utmp: utmp and wtmp entry formats utmp(4) 

getgrent: get group file entry getgrent(3C) 

getpwent: get password file entry getpwent(3C) 

getutent: access utmp file entry getut(3C) 

name for file symbol table entry, /retrieve symbol ldgetname(3X) 

the index of a symbol table entry of a file, /compute ldtbindex(3X) 

read an indexed symbol table entry of a file, ldtbread: ldtbread(3X) 

putpwent: write password file entry putpwent(3C) 

rje: RJE (Remote Job Entry) to IBM rje(8) 

unlink: remove directory entry unlink(2) 

command execution, env: set environment for env(l) 

environ: user environment environ (5) 

profile: setting up an environment at login time profile(4) 

environ: user environment environ (5) 

execution, env: set environment for command env(l) 

getenv: return value for environment name getenv(3C) 

putenv: change or add value to environment putenv(3C) 
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getenv: return Fortran environment variable getenv(3F) 

sky: obtain ephemerides sky(6) 

complementary error function, erf: error function and erf(3M) 

err: error-logging interface err(7) 

from dump, errdead: extract error records errdead(lM) 

daemon, errdemon: error-logging errdemon(lM) 

format, errfile: error-log file errfile(4) 

complementary error/ erf: error function and erf(3M) 

function and complementary error function, erf: error erf(3M) 

perror: system error messages perror(3C) 

to system calls and error numbers, /introduction intro(2) 

errdead: extract error records from dump errdead(lM) 

matherr: error-handling function matherr(3M) 

errfile: error-log file format errfile(4) 

errdemon: error-logging daemon errdemon(lM) 

errstop: terminate the error-logging daemon errstop(lM) 

err: error-logging interface err(7) 

process a report of logged errors, errpt: errpt (1M) 

spell: find spelling errors spell(l) 

logged errors, errpt: process a report of errpt(lM) 

error-logging daemon, errstop: terminate the errstop(lM) 

terminal line/ dial: establish an out-going dial (3C) 

setmnt: establish mount table setmnt(lM) 

hypot: Euclidean distance function hypot(3M) 

expression, expr: evaluate arguments as an expr(l) 

test: condition evaluation command test(l) 

vpmsave: save and print VPM event traces vpmsave(lM) 

trace: event-tracing driver trace (7) 

ex: text editor ex(l) 

crash: examine system images crash (1M) 

execl: execute a file exec(2) 

network.net: execute a command on the PCL .... net(lC) 

execl: execute a file exec(2) 

construct argument list(s) and execute command., xargs: xargs(l) 

time, at: execute commands at a later at(l) 

regcmp: compile and execute regular expression regcmp(3X) 

set environment for command execution, env: env(l) 

sleep: suspend execution for an interval sleep(l) 

sleep: suspend execution for interval sleep(3C) 

monitor: prepare execution profile monitor(3C) 

profil: execution time profile profil(2) 

UNIX-to-UNIX system command execution, uux: uux(lC) 

system calls, link: exercise link and unlink link(lM) 

a new file or rewrite an existing one. creat: create creat(2) 

exit: terminate process exit(2) 

power, square root functions, exp: exponential, logarithm, exp(3M) 

intrinsic function, exp: Fortran exponential exp(3F) 

pack: compress and expand files pack(l) 

conversion, int: explicit Fortran type ftype(3F) 

function, exp: Fortran exponential intrinsic exp(3F) 

square root functions, exp: exponential, logarithm, power, .... exp(3M) 

expression, expr: evaluate arguments as an .... expr(l) 

routines, regexp: regular expression compile and match regexp(5) 

regcmp: regular expression compile regcmp(l) 

expr: evaluate arguments as an expression expr(l) 

compile and execute regular expression, regcmp: regcmp(3X) 

efl: Extended Fortran Language efl(l) 

dump, errdead: extract error records from errdead (1M) 

f77: Fortran 77 compiler f77(l) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

factor: factor a number factor(l) 

factor: factor a number factor(l) 

data in a machine-independent fashion /access long integer sputl(3X) 

fine: fast incremental backup finc(lM) 
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malloc: fast main memory allocator malloc(3X) 

procedure, checkall: faster file system checking checkall(lM) 

abort: generate an IOT fault abort(3C) 

stream, fclose: close or flush a . fclose(3S) 

fcntl: file control fcntl (2) 

fcntl: file control options fcntl (5) 

inquiries, ferror: stream status ferror(3S) 

statistics for a file system, ff: list file names and flf(lM) 

times, utime: set file access and modification utime(2) 

Idfcn: common object file access routines ldfcn(4) 

determine accessibility of a file, access: access (2) 

hpio: HP 2645A terminal tape file archiver hpio(l) 

tar: tape file archiver tar(l) 

cpio: copy file archives in and out cpio(l) 

pwck: password/group file checkers pwck(lM) 

chmod: change mode of file chmod(2) 

change owner and group of a file, chown: chown(2) 

diff : differential file comparator diff(l) 

difT3: 3-way differential file comparison diff3(l) 

fcntl: file control fcntl (2) 

fcntl: file control options fcntl(5) 

public UNIX-to-UNIX system file copy, uuto: uuto(lC) 

core: format of core image file core(4) 

umask: set and get file creation mask umask(2) 

crontab: user crontab file crontab(l) 

fields of each line of a file, cut: cut out selected cut(l) 

dd: convert and copy a file dd(l) 

a delta (change) to an SCCS file, delta: make delta ( 1 ) 

close: close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

file: determine file type file(l) 

selected parts of an object file, dump: dump dump(l) 

sact: print current SCCS file editing activity sact(l) 

getgrent: get group file entry getgrent(3C) 

getpwent: get password file entry getpwent(3C) 

getutent: access utmp file entry getut(3C) 

putpwent: write password file entry putpwent(3C) 

execl: execute a file exec(2) 

grep: search a file for a pattern grep(l) 

ldopen: open a common object file for reading ldopen(3X) 

acct: per-process accounting file format acct(4) 

ar: common archive file format ar(4) 

ar: archive file format ar.pdp(4) 

errfile: error-log file format errfile(4) 

pnch: file format for card images pnch(4) 

intro: introduction to file formats intro(4) 

line number entries of a file function, /manipulate ldlread(3X) 

get: get a version of an SCCS file get(l) 

group: group file group(4) 

files, filehdr: file header for common object filehdr(4) 

file, ldfhread: read the file header of a common object .... ldfhread(3X) 

ldohseek: seek to the optional file header of a file ldohseek(3X) 

fixed-head disk file, hs: RH1 1/RJS03-RJS04 hs.pdp(7) 

split: split a file into pieces split(l) 

issue: issue identification file issue (4) 

ldclose: close a common object file ldclose(3X) 

file header of a common object file, ldfhread: read the ldfhread (3 X) 

entries of a section of a file, /seek to line number ldlseek(3X) 

the optional file header of a file, ldohseek: seek to ldohseek(3X) 

entries of a section of a file, /seek to relocation ldrseek(3X) 

section header of a file, /read an indexed/named ldshread(3X) 

section of an object file, /to an indexed/named ldsseek(3X) 

of a symbol table entry of a file, /compute the index ldtbindex (3X) 

symbol table entry of a file, /read an indexed ldtbread(3X) 
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table of a common object 
entries in a common object 
link: link to a 
mknod: build special 
or a special or ordinary 
ctermid: generate 
mktemp: make a unique 
a file system, ff: list 
change the format of a text 
name list of common object 
null: the null 
/find the slot in the utmp 
/identify processes using a 
one. creat: create a new 
passwd: password 
merge same lines of several 
soft-copy terminals, pg: 

fseek: reposition a 
lseek: move read/write 
prs: print an SCCS 
read: read from 
for a common object 
rf: RF1 1/RSI 1 fixed-head disk 
remove a delta from an SCCS 
bfs: big 

two versions of an SCCS 
sccsfile: format of SCCS 
header for a common object 
stat: get 

line number information from a 
processes using a file or 
checksum and block count of a 
/retrieve symbol name for 
syms: common object 
daily/weekly UNIX system 
procedure, checkall: faster 
fsck: 
fsdb: 

names and statistics for a 
volume, 
mkfs: construct a 
mount: mount and dismount 
mount: mount a 
ustat: get 
mnttab: mounted 
umount: unmount a 
access time, dcopy: copy 
fsck. checklist: list of 
checking, volcopy: copy 
deliver the last part of a 
term: format of compiled term 
tmpfile: create a temporary 
create a name for a temporary 
mkboot: convert a.out 
and modification times of a 
ftw: walk a 
file: determine 
undo a previous get of an SCCS 
report repeated lines in a 
val: validate SCCS 
write: write on a 
umask: set 
common object files, 
and print process accounting 


file, /seek to the symbol 
file, linenum: line number 

file 

file 

file, /make a directory, 
file name for terminal. . . 

file name 

file names and statistics for 

file, newform: 

file, nm: print 

file 

file of the current user. . . 
file or file structure. . . . 
file or rewrite an existing . 

file 

file paste: 

file perusal filter for ... 
file pointer in a stream. 

file pointer 

file 

file 

file, /relocation information 

file ■ . . 

file, rmdel: 

file scanner 

file, sccsdiff: compare . . 

file 

file, scnhdr: section . . . 

file status 

file, strip: strip symbol and 
file structure, /identify . . 

file, sum: print 

file symbol table entry. . . 
file symbol table format. . 
file system backup, filesave: 
file system checking . . . 
file system consistency check 
file system debugger. . . 
file system, ff: list file . . 
file system: format of system 

file system 

file system 

file system 

file system statistics. . . . 

file system table 

file system 

file systems for optimal 
file systems processed by . 
file systems with label . . 

file, tail: 

file 

file 

file, tmpnam: 

file to boot image 

file, touch: update access . 

file tree 

file type 

file, unget: 

file, uniq: 

file 

file. . . 

file-creation mode mask, 
filehdr: file header for . . 
file(s). acctcom: search 


. ldtbseek(3X) 

. linenum(4) 

. link(2) 

. mknod(lM) 

. mknod (2) 

. ctermid(3S) 

. mktemp(3C) 

. ff(lM) 

. newform(l) 

. nm(l) 

. null(7) 

. ttyslot(3C) 

. fuser (1M) 

. creat (2) 

. passwd (4) 

. paste(l) 

• Pg(D 
. fseek (3S) 

. lseek (2) 

. prs ( 1 ) 

. read (2) 

. reloc(4) 

. rf.pdp(7) 

. rmdel(l) 

. bfs(l) 

. sccsdiff(l) 

. sccsfile (4) 

. scnhdr(4) 

. stat(2) 

. strip(l) 

. fuser(lM) 
sum(l) 

ldgetname(3X) 
syms (4) 
filesave(lM) 
checkall ( 1 M) 
fsck(lM) 
fsdb(lM) 
ff(lM) 
fs(4) 

mkfs(lM) 
mount(lM) 
mount (2) 
ustat(2) 
mnttab(4) 
umount(2) 
dcopy (1M) 
checklist(4) 
volcopy (1M) 
tail(l) 
term (4) 
tmpfile(3S) 
tmpnam (3S) 
mkboot(lM) 
touch (l) 
ftw (30 
file(l) 
unget(l) 
uniq(l) 
val ( 1 ) 
write (2) 
umask(l) 
filehdr(4) 
acctcom (1) 
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merge or add total accounting files, acctmerg: acctmerg(lM) 

create and administer SCCS files, admin: admin(l) 

send: gather files and/or submit RJE jobs send(lC) 

VAX-1 1/780/ fscv: convert files between PDP-1 1 and fscv.vax(lM) 

cat: concatenate and print files cat(l) 

cmp: compare two files cmp(l) 

lines common to two sorted files, comm: select or reject comm(l) 

cp, In, mv: copy, link or move files cp(l) 

mark differences between files, diffmk: diffmk(l) 

file header for common object files, filehdr: filehdr (4) 

find: find files find(l) 

free: recover files from a backup tape freed M) 

format, arev: convert archive files from PDP-1 1 to common arcv.pdp(l) 

format specification in text files, fspec: fspec(4) 

split f77, ratfor, or efl files, fsplit: fsplit(l) 

string, format of graphical files, /graphical primitive gps (4) 

cpset: install object files in binary directories cpset(lM) 

intro: introduction to special files intro(7) 

link editor for common object files. Id: ldO) 

rm: remove files or directories rm(l) 

pack: compress and expand files pack(l) 

pr: print files pr(l) 

section sizes of common object files, size: print size(l) 

size: print sizes of object files size.pdp(l) 

sort: sort and/or merge files sort(l) 

/convert object/archive files to common formats convert(l) 

what: identify SCCS files what(l) 

system file system backup, filesave: daily/weekly UNIX filesave(lM) 

terminals, pg: file perusal filter for soft-copy . PgU) 

greek: select terminal filter greek(l) 

nl: line numbering filter nl(l) 

col: filter reverse line-feeds cold) 

graphical device routines and filters, hpd: gdev(lG) 

tplot: graphics filters tplot(lG) 

fine: fast incremental backup fined M) 

find: find files find(l) 

find: find files find(l) 

ttyname: find name of a terminal ttyname(3C) 

object library, lorder: find ordering relation for an lorder(l) 

spell: find spelling errors spell (1) 

of the current user, ttyslot: find the slot in the utmp file ttyslot(3C) 

tee: pipe fitting tee(l) 

hs: RH1 1/RJS03-RJS04 fixed-head disk file hs.pdp(7) 

rf: RFU/RS1 1 fixed-head disk file rf.pdp(7) 

string, ecvt: convert floating-point number to ecvt(3C) 

frexp: manipulate parts of floating-point numbers frexp(3C) 

absolute value/ floor: floor, ceiling, remainder floor(3M) 

remainder, absolute value/ floor: floor, ceiling, floor(3M) 

vlx: VAX-11/780 LSI console floppy interface vlx(lM) 

cflow: generate C flow graph cflow(l) 

fclose: close or flush a stream fclose(3S) 

fopen: open a stream fopen(3S) 

fork: create a new process fork(2) 

per-process accounting file format, acct: acct(4) 

RM05 disk packs, format: format and/or check RP06 and .... format(lM) 

ar: common archive file format ar(4) 

files from PDP-11 to common format, arev: convert archive arcv.pdpd) 

ar: archive file format ar.pdp(4) 

errfile: error-log file format errfile(4) 

pnch: file format for card images pnch(4) 

RP06 and RM05 disk packs, format: format and/or check format(lM) 

newform: change the format of a text file newform(l) 

inode: format of an i-node inode(4) 

term: format of compiled term file term (4) 
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core: format of core image file core(4) 

cpio: format of cpio archive cpio(4) 

dir: format of directories dir (4) 

/graphical primitive string, format of graphical files gps(4) 

sccsfile: format of SCCS file sccsfile(4) 

file system: format of system volume fs(4) 

files, fspec: format specification in text fspec(4) 

object file symbol table format, syms: common syms(4) 

object/archive files to common formats, convert: convert convert(l) 

intro: introduction to file formats intro(4) 

utmp: utmp and wtmp entry formats utmp(4) 

scanf: convert formatted input scanf(3S) 

argument list, vprintf: print formatted output of a varargs vprintf(3S) 

argument list, vprintf: print formatted output of a varargs vprintf(3X) 

printf: print formatted output printf(3S) 

f77: Fortran 77 compiler f77(l) 

abs: Fortran absolute value abs(3F) 

system/ signal: specify Fortran action on receipt of a signal (3F) 

function, acos: Fortran arccosine intrinsic acos(3F) 

function, asin: Fortran arcsine intrinsic asin(3F) 

function. atan2: Fortran arctangent intrinsic atan2(3F) 

function, atan: Fortran arctangent intrinsic atan(3F) 

and, or, xor, not: Fortran boolean functions bool(3F) 

getarg: return Fortran command-line argument. . . . getarg(3F) 

intrinsic function, log 10: Fortran common logarithm log 10 (3 F) 

intrinsic function, conjg: Fortran complex conjugate conjg(3F) 

function, cos: Fortran cosine intrinsic cos(3F) 

ratfor: rational Fortran dialect ratfor(l) 

getenv: return Fortran environment variable getenv(3F) 

function, exp: Fortran exponential intrinsic exp(3F) 

intrinsic function, cosh: Fortran hyperbolic cosine cosh(3F) 

intrinsic function, sinh: Fortran hyperbolic sine sinh(3F) 

intrinsic function, tanh: Fortran hyperbolic tangent tanh(3F) 

complex argument, aimag: Fortran imaginary part of aimag(3F) 

function, aint: Fortran integer part intrinsic aint(3F) 

efl: Extended Fortran Language efl(l) 

functions, max: Fortran maximum-value max(3F) 

functions, min: Fortran minimum-value min(3F) 

intrinsic function, log: Fortran natural logarithm log(3F) 

functions, anint: Fortran nearest integer round(3F) 

abort: terminate Fortran program abort (3F) 

functions, mod: Fortran remaindering intrinsic .... mod(3F) 

function, sin: Fortran sine intrinsic sin(3F) 

function, sqrt: Fortran square root intrinsic sqrt(3F) 

len: return length of Fortran string len(3F) 

index: return location of Fortran substring index(3F) 

issue a shell command from Fortran, system: systcm(3F) 

function, tan: Fortran tangent intrinsic tan(3F) 

mclock: return Fortran time accounting. mclock(3F) 

intrinsic function, sign: Fortran transfer-of-sign sign(3F) 

int: explicit Fortran type conversion ftype(3F) 

fread: binary input/output fread(3S) 

backup tape, free: recover files from a freed M) 

df: report number of free disk blocks df(lM) 

floating-point numbers, frexp: manipulate parts of frexp(3C) 

free: recover files from a backup tape frec(lM) 

and line number information from a file, /strip symbol strip(l) 

getc: get character or word from a stream getc(3S) 

gets: get a string from a stream gets(3S) 

rmdel: remove a delta from an SCCS file rmdel(l) 

getopt: get option letter from argument vector getopt(3C) 

errdead: extract error records from dump errdead(lM) 

read: read from file read (2) 

system: issue a shell command from Fortran system(3F) 
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ncheck: generate names from i-numbers ncheck(lM) 

nlist: get entries from name list nlist(3C) 

arcv: convert archive files from PDP-11 to common format. . . . arcv.pdp(l) 

acctcms: command summary from per-process accounting/ acctcms(l M) 

getpw: get name from UID getpw(3C) 

of file systems processed by fsck. checklist: list checklist^) 

check fsck: file system consistency fsck(lM) 

PDP-11 and VAX-11/780/ fscv: convert files between fscv.vax(lM) 

fsdb: file system debugger fsdb(lM) 

pointer in a stream, fseek: reposition a file fseek(3S) 

text files, fspec: format specification in fspec(4) 

efl files, fsplit: split f77, ratfor, or ...... . fsplit(l) 

communication package, ftok: standard interprocess stdipc(3C) 

ftw: walk a file tree ftw(3C) 

Fortran arccosine intrinsic function, acos: acos(3F) 

Fortran integer part intrinsic function, aint: aint(3F) 

error function, erf: error function and complementary erf(3M) 

Fortran arcsine intrinsic function, asin: asin(3F) 

Fortran arctangent intrinsic function. atan2: atan2(3F) 

Fortran arctangent intrinsic function, atan: atan(3F) 

complex conjugate intrinsic function, conjg: Fortran conjg(3F) 

cos: Fortran cosine intrinsic function cos(3F) 

hyperbolic cosine intrinsic function, cosh: Fortran cosh (3 F) 

precision product intrinsic function, dprod: double dprod(3F) 

and complementary error function, erf: error function erf(3M) 

Fortran exponential intrinsic function, exp: exp(3F) 

gamma: log gamma function gamma (3 M) 

hypot: Euclidean distance function hypot(3M) 

line number entries of a file function, ldlread: manipulate ldlread(3X) 

common logarithm intrinsic function, log 10: Fortran logl0(3F) 

natural logarithm intrinsic function, log: Fortran log(3F) 

matherr: error-handling function matherr(3M) 

prof: profile within a function prof (5) 

transfer-of-sign intrinsic function, sign: Fortran sign(3F) 

sin: Fortran sine intrinsic function sin(3F) 

hyperbolic sine intrinsic function, sinh: Fortran sinh(3F) 

Fortran square root intrinsic function, sqrt: sqrt(3F) 

tan: Fortran tangent intrinsic function tan(3F) 

hyperbolic tangent intrinsic function, tanh: Fortran tanh(3F) 

math: math functions and constants math (5) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

or, xor, not: Fortran boolean functions, and, bool (3 F) 

positive difference intrinsic functions, dim: dim(3F) 

logarithm, power, square root functions, exp: exponential, exp(3M) 

remainder, absolute value functions, /floor, ceiling, floor(3M) 

max: Fortran maximum-value functions max(3F) 

min: Fortran minimum-value functions min(3F) 

Fortran remaindering intrinsic functions, mod: mod(3F) 

hp: handle special functions of HP terminals hp(l) 

terminal. 450: handle special functions of the DASI 450 450(1) 

anint: Fortran nearest integer functions round (3 F) 

sinh: hyperbolic functions sinh(3M) 

string comparision intrinsic functions, lge: strcmp(3F) 

sin: trigonometric functions trig(3M) 

using a file or file/ fuser: identify processes fuser(lM) 

accounting records, fwtmp: manipulate connect fwtmp(lM) 

jotto: secret word game jotto(6) 

moo: guessing game moo (6) 

back: the game of backgammon back(6) 

bj: the game of black jack bj(6) 

chess: the game of chess chess (6) 

craps: the game of craps craps(6) 

reversi: a game of dramatic reversals reversi(6) 

wump: the game of hunt-the-wumpus wump(6) 
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intro: introduction to games intro (6) 

gamma: log gamma function gamma(3M) 

gamma: log gamma function gamma(3M) 

jobs, send: gather files and/or submit RJE .... send (1C) 

moving-head disks, gd: general driver for gd(7) 

ged: graphical editor ged(lG) 

maze: generate a maze maze (6) 

abort: generate an IOT fault abort (3C) 

cflow: generate C flow graph cflow(l) 

cross-reference, cxref: generate C program cxref(l) 

crypt: generate DES encryption crypt(3C) 

by user ID. diskusg: generate disk accounting data diskusg(lM) 

makekey: generate encryption key makekey(l) 

terminal, ctermid: generate file name for ctermid(3S) 

ncheck: generate names from i-numbers ncheck(lM) 

lexical tasks, lex: generate programs for simple lex(l) 

pseudo-random/ drand48: generate uniformly distributed .... drand48(3C) 

rand: simple random-number generator rand(3C) 

irand: random number generator rand(3F) 

gets: get a string from a stream gets(3S) 

get: get a version of an SCCS file get(l) 

ulimit: get and set user limits ulimit(2) 

the user, cuserid: get character login name of cuserid(3S) 

stream, getc: get character or word from a getc(3S) 

nlist: get entries from name list nlist(3C) 

umask: set and get file creation mask umask(2) 

stat: get file status stat(2) 

ustat: get file system statistics. ustat(2) 

file, get: get a version of an SCCS get(l) 

getgrent: get group file entry getgrent(3C) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

msgget: get message queue msgget(2) 

getpw: get name from UID getpw(3C) 

system, uname: get name of current UNIX uname(2) 

unget: undo a previous get of an SCCS file unget(l) 

argument vector, getopt: get option letter from getopt(3C) 

getpwent: get password file entry getpwent(3C) 

working directory, getcwd: get path-name of current getcwd(3C) 

times, times: get process and child process times(2) 

and parent process/ getpid: get process, process group, getpid(2) 

semget: get set of semaphores semget(2) 

shmget: get shared memory segment shmget(2) 

tty: get the name of the terminal tty(l) 

time: get time time(2) 

getuid: get user IDs getuid(2) 

command-line argument, getarg: return Fortran getarg(3F) 

from a stream, getc: get character or word getc(3S) 

current working directory, getcwd: get path-name of getcwd(3C) 

environment variable, getenv: return Fortran getenv(3F) 

environment name, getenv: return value for getenv(3C) 

entry, getgrent: get group file getgrent(3C) 

getlogin: get login name getlogin (3C) 

argument vector, getopt: get option letter from getopt (3C) 

getopt: parse command options getopt (1) 

getpass: read a password getpass(3C) 

group, and parent process/ getpid: get process, process getpid (2) 

getpw: get name from UID getpw (3C) 

entry, getpwent: get password file getpwent (3C) 

stream, gets: get a string from a gets(3S) 

and terminal settings used by getty. gettydefs: speed gettydefs(4) 

modes, speed, and line/ getty: set terminal type, getty(lM) 

ct: spawn getty to a remote terminal ct(lC) 

settings used by getty. gettydefs: speed and terminal gettydefs (4) 
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getuid: get user IDs getuid(2) 

entry, getutent: access utmp file getut(3C) 

setjmp: non-local goto setjmp(3C) 

string, format of graphical/ gps: graphical primitive gps(4) 

cflow: generate C flow graph cflow(l) 

graph: draw a graph graph(lG) 

graph: draw a graph graph(lG) 

sag: system activity graph sag(lG) 

commands, graphics: access graphical and numerical graphics(lG) 

/network useful with graphical commands stat(lG) 

filters, hpd: graphical device routines and gdev(lG) 

ged: graphical editor ged(lG) 

primitive string, format of graphical files, /graphical gps (4) 

format of graphical/ gps: graphical primitive string gps(4) 

routines, toe: graphical table of contents toc(lG) 

gutil: graphical utilities gutil(lG) 

numerical commands, graphics: access graphical and .... graphics(lG) 

tplot: graphics filters tplot(lG) 

plot: graphics interface plot(4) 

subroutines, plot: graphics interface plot(3X) 

greek: select terminal filter greek(l) 

pattern, grep: search a file for a grep(l) 

getpid: get process, process group, and parent process IDs getpid (2) 

chown: change owner or group chown(l) 

getgrent: get group file entry getgrent(3C) 

group: group file group(4) 

group: group file group(4) 

setpgrp: set process group ID setpgrp(2) 

id: print user and group IDs and names id(l) 

setuid, setgid: set user and group IDs setuid(2) 

newgrp: log in to a new group newgrp(l) 

chown: change owner and group of a file chown (2) 

a signal to a process or a group of processes, /send kill (2) 

update, and regenerate groups of programs, /maintain, .... make(l) 

drives, gt: general driver for tape gt(7) 

hangman: guess the word hangman(6) 

moo: guessing game moo (6) 

gutil: graphical utilities gutil (1G) 

terminals, hp: handle special functions of HP .... hp(l) 

the DASI 450 terminal. 450: handle special functions of 450(1) 

varargs: handle variable argument list varargs(5) 

package, curses: CRT screen handling and optimization curses (3X) 

hangman: guess the word hangman(6) 

nohup: run a command immune to hangups and quits nohup(l) 

hsearch: manage hash search tables hsearch(3C) 

file, scnhdr: section header for a common object scnhdr(4) 

files, filehdr: file header for common object filehdr(4) 

ldahread: read the archive header ldahread(3X) 

file, ldfhread: read the file header of a common object ldfhread(3X) 

seek to the optional file header of a file, ldohseek: ldohseek(3X) 

read an indexed/named section header of a file, ldshread: ldshread(3X) 

help: ask for help help(l) 

help: ask for help help(l) 

hm: RM05 moving-head disk hm(7) 

archiver, hpio: HP 2645A terminal tape file hpio(l) 

of HP terminals, hp: handle special functions hp(l) 

moving-head disk, hp: RP04/RP05/RP06 hp(7) 

handle special functions of HP terminals, hp: hp(l) 

and filters, hpd: graphical device routines gdev(lG) 

file archiver, hpio: HP 2645A terminal tape .... hpio(l) 

fixed-head disk file, hs: RH1 1/RJS03-RJS04 hs.pdp(7) 

tables, hsearch: manage hash search hsearch(3C) 

interface, ht: TU16/TE16 magnetic tape .... ht(7) 

wump: the game of hunt-the-wumpus wump(6) 
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function, cosh: Fortran hyperbolic cosine intrinsic cosh(3F) 

sinh: hyperbolic functions sinh(3M) 

function, sinh: Fortran hyperbolic sine intrinsic sinh(3F) 

function, tanh: Fortran hyperbolic tangent intrinsic tanh(3F) 

function, hypot: Euclidean distance hypot(3M) 

iargc iargc(3F) 

rje: RJE (Remote Job Entry) to IBM rje(8) 

disk accounting data by user ID. diskusg: generate diskusg(lM) 

and names, id: print user and group IDs id ( 1 ) 

setpgrp: set process group ID setpgrp(2) 

issue: issue identification file issue(4). 

file or file/ fuser: identify processes using a fuser(lM) 

what: identify SCCS files what(l) 

id: print user and group IDs and names id(l) 

group, and parent process IDs. /get process, process getpid(2) 

getuid: get user IDs getuid(2) 

setgid: set user and group IDs. setuid, setuid(2) 

core: format of core image file core (4) 

convert a. out file to boot image, mkboot: mkboot(lM) 

crash: examine system images crash(lM) 

pnch: file format for card images. . pnch(4) 

argument, aimag: Fortran imaginary part of complex aimag(3F) 

nohup: run a command immune to hangups and quits nohup(l) 

fine: fast incremental backup finc(l M) 

of a/ ldtbindex: compute the index of a symbol table entry ldtbindex(3X) 

Fortran substring, index: return location of index(3F) 

a file, ldtbread: read an indexed symbol table entry of ldtbread(3X) 

of a file, ldshread: read an indexed/named section header .... ldshread(3X) 

object/ ldsseek; seek to an indexed/named section of an ldsseek(3X) 

initialization, init: process control init(lM) 

inittab: script for the init process inittab(4) 

init: process control initialization init(lM) 

bre: system initialization shell scripts brc(lM) 

information bdblk: print, initialize, update bad bdblk(lM) 

process, popen: initiate pipe to/from a popen(3S) 

process, inittab: script for the init inittab(4) 

clri: clear i-node clri(lM) 

inode: format of an i-node inode(4) 

inode: format of an i-node inode(4) 

scanf: convert formatted input scanf(3S) 

push character back into input stream, ungetc: ungetc(3S) 

fread: binary input/output fread(3S) 

stdio: standard buffered input/output package stdio(3S) 

ferror: stream status inquiries ferror(3S) 

uustat: uucp status inquiry and job control uustat(lC) 

install: install commands install(lM) 

install: install commands install (1M) 

directories, cpset: install object files in binary cpset(lM) 

conversion, int: explicit Fortran type ftype(3F) 

abs: return integer absolute value abs(3C) 

a641: convert between long integer and base-64 ASCII/ a641(3C) 

sputl: access long integer data in a/ sputl(3X) 

anint: Fortran nearest integer functions round(3F) 

function, aint: Fortran integer part intrinsic aint(3F) 

strtol: convert string to integer strtol(3C) 

13tol: convert between 3-byte integers and long integers 13tol(3C) 

3-byte integers and long integers, /convert between 13tol(3C) 

bcopy: interactive block copy bcopy(lM) 

system, mailx: interactive message processing .... mailx(l) 

acu: Automatic Call Unit (ACU) interface acu(7) 

du: DU- 1 1 synchronous line interface du.pdp(7) 

err: error-logging interface err(7) 

ht: TU16/TE16 magnetic tape interface ht(7) 

KL-11 orDL-11 asynchronous interface, kl: kl.pdp(7) 
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parallel communications link interface, pci; pci (7) 

plot: graphics interface plot (4) 

plot: graphics interface subroutines plot(3X) 

termio: general terminal interface termio(7) 

tm: TM1 1 /TUI 0 magnetic tape interface tm.pdp(7) 

ts: TS 11 magnetic tape interface tsl 1 (7) 

tty: controlling terminal interface tty (7) 

tu78: TU78 magnetic tape interface tu78(7) 

VAX-1 1/780 LSI console floppy interface, vlx: vlx(lM) 

spline: interpolate smooth curve spline(lG) 

characters, asa: interpret ASA carriage control .... asa(l) 

sno: SNOBOL interpreter sno(l) 

pipe: create an interprocess channel pipe(2) 

facilities/ ipcs: report inter-process communication ipcs(l) 

package, ftok: standard interprocess communication stdipc(3C) 

suspend execution for an interval, sleep: sleep(l) 

sleep: suspend execution for interval sleep(3C) 

acos: Fortran arccosine intrinsic function acos(3F) 

aint: Fortran integer part intrinsic function aint(3F) 

asin: Fortran arcsine intrinsic function asin(3F) 

atan2: Fortran arctangent intrinsic function atan2(3F) 

atan: Fortran arctangent intrinsic function atan(3F) 

Fortran complex conjugate intrinsic function, conjg: conjg(3F) 

cos: Fortran cosine intrinsic function cos(3F) 

Fortran hyperbolic cosine intrinsic function, cosh: cosh (3 F) 

double precision product intrinsic function, dprod: dprod(3F) 

exp: Fortran exponential intrinsic function exp(3F) 

Fortran common logarithm intrinsic function, log 10: log 1 0(3F) 

log: Fortran natural logarithm intrinsic function log(3F) 

sign: Fortran transfer-of-sign intrinsic function sign(3F) 

sin: Fortran sine intrinsic function sin(3F) 

sinh: Fortran hyperbolic sine intrinsic function sinh(3F) 

sqrt: Fortran square root intrinsic function sqrt(3F) 

tan: Fortran tangent intrinsic function tan(3F) 

Fortran hyperbolic tangent intrinsic function, tanh: tanh(3F) 

dim: positive difference intrinsic functions dim(3F) 

mod: Fortran remaindering intrinsic functions mod(3F) 

lge: string comparision intrinsic functions strcmp(3F) 

commands intro: introduction to intro(l) 

formats, intro: introduction to file intro (4) 

intro: introduction to games intro (6) 

maintenance commands intro: introduction to intro(lM) 

miscellany, intro: introduction to intro (5) 

files, intro: introduction to special intro(7) 

subroutines and libraries, intro: introduction to intro(3) 

calls and error numbers, intro: introduction to system intro (2) 

maintenance procedures, intro: introduction to system intro(8) 

intro: introduction to commands intro(l) 

intro: introduction to file formats intro(4) 

intro: introduction to games ' intro(6) 

commands intro: introduction to maintenance intro(lM) 

intro: introduction to miscellany intro(5) 

intro: introduction to special files intro(7) 

and libraries, intro: introduction to subroutines intro(3) 

and error numbers, intro: introduction to system calls intro (2) 

maintenance/ intro: introduction to system intro (8) 

ncheck: generate names from i-numbers ncheck(lM) 

ioctl: control device ioctl (2) 

abort: generate an IOT fault abort(3C) 

ipcrm: remove a message queue .... ipcrm(l) 

communication facilities/ ipcs: report inter-process ipcs(l) 

generator, irand: random number rand (3 F) 

isalpha: classify characters ctype(3C) 

Fortran, system: issue a shell command from system(3F) 
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system: issue a shell command system(3S) 

issue: issue identification file issue (4) 

file, issue: issue identification issue (4) 

news: print news items news(l) 

functions. jO, jl, jn, yO, yl, yn: Bessel bessel(3M) 

functions. jO, jl, jn, yO, yl, yn: Bessel bessel(3M) 

bj: the game of black jack bj(6) 

functions. jO, jl, jn, yO, yl, yn: Bessel bessel(3M) 

operator, join: relational database join(l) 

jotto: secret word game jotto(6) 

fortheKMCllB kasb: assembler/un-assembler kasb(l) 

makekey: generate encryption key makekey(l) 

killall: kill all active processes killall ( 1 M) 

process or a group of/ kill: send a signal to a kill (2) 

kill: terminate a process kill (1 ) 

processes, killall: kill all active killall (1M) 

asynchronous interface, kl: KL-11 or DL-1 1 kl.pdp(7) 

interface, kl: KL-11 or DL-1 1 asynchronous .... kl.pdp(7) 

microprocessor, kmc: KMC-1 1B/KMS1 1 kmc(7) 

vpmtest: test KMC lines vpmtest(lM) 

connect DM1 1 -BA modems to KMC1 1-B dmkset: dmkset(lM) 

assembler/un-assembler for the KMCllBkasb: kasb(l) 

microprocessor, kmc: KMC-1 1B/KMS1 1 kmc(7) 

quiz: test your knowledge quiz(6) 

integers and long integers. 13tol: convert between 3-byte 13tol(3C) 

copy file systems with label checking, volcopy: volcopy(lM) 

scanning and processing language, awk: pattern awk(l) 

arbitrary-precision arithmetic language.be: bc(l) 

efl: Extended Fortran Language efl(l) 

epp: the C language preprocessor cpp(l) 

command programming language, /standard/restricted .... sh(l) 

shl: shell layer manager shl(l) 

object files. Id: link editor for common Id (1 ) 

Id: link editor ld.pdp(l) 

header ldahread: read the archive ldahread(3X) 

file, ldclose: close a common object .... ldclose(3X) 

access routines, ldfcn: common object file ldfcn(4) 

of a common object file, ldfhread: read the file header ldfhread(3X) 

name for file symbol table/ ldgetname: retrieve symbol ldgetname(3X) 

number entries of a file/ ldlread: manipulate line ldlread(3X) 

entries of a section of a / ldlseek: seek to line number ldlseek(3X) 

file header of a file, ldohseek: seek to the optional ldohseek(3X) 

file for reading, ldopen: open a common object .... ldopen(3X) 

entries of a section of a/ ldrseek: seek to relocation ldrseek(3X) 

indexed/named section header/ ldshread: read an ldshread(3X) 

indexed/named section of an/ ldsseek: seek to an ldsseek(3X) 

of a symbol table entry of a/ ldtbindex: compute the index ldtbindex(3X) 

symbol table entry of a file, ldtbread: read an indexed ldtbread(3X) 

table of a common object/ ldtbseek: seek to the symbol ldtbseek(3X) 

string, len: return length of Fortran len(3F) 

len: return length of Fortran string len(3F) 

getopt: get option letter from argument vector getopt(3C) 

simple lexical tasks, lex: generate programs for lex(l) 

generate programs for simple lexical tasks, lex: lex(l) 

intrinsic functions, lge: string comparision strcmp(3F) 

to subroutines and libraries, /introduction intro(3) 

relation for an object library, /find ordering lorder(l) 

ar: archive and library maintainer ar.pdp(l) 

portable/ ar: archive and library maintainer for ar(l) 

ulimit: get and set user limits ulimit(2) 

an out-going terminal line connection, /establish dial (3C) 

type, modes, speed, and line discipline. /set terminal getty(lM) 

du: DU-11 synchronous line interface du.pdp(7) 

line: read one line line(l) 
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common object file, linenum: line number entries in a linenum(4) 

function, ldlread: manipulate line number entries of a file ldlread(3X) 

section of a/ ldlseek: seek to line number entries of a ldlseek(3X) 

file, strip: strip symbol and line number information from a .... strip(l) 

nl: line numbering filter nl(l) 

out selected fields of each line of a file, cut: cut cut(l) 

send/cancel requests to an LP line printer. Ip, cancel: lp(l) 

lp: line printer lp(7) 

line: read one line line(l) 

lsearch: linear search and update lsearch(3C) 

col: filter reverse line-feeds col ( 1 ) 

in a common object file, linenum: line number entries linenum (4) 

files, comm: select or reject lines common to two sorted comm(l) 

uniq: report repeated lines in a file uniq(l) 

paste: merge same lines of several file paste(l) 

vpmtest: test KMC lines vpmtest(lM) 

link: exercise link and unlink system calls link(lM) 

files. Id: link editor for common object ld(l) 

Id: link editor ld.pdp(l) 

a. out: common assembler and link editor output a.out(4) 

a.out: PDP-1 1 assembler and link editor output a.out.pdp(4) 

system calls, link: exercise link and unlink link(lM) 

pci: parallel communications link interface pcl(7) 

link: link to a file link(2) 

pcldaemon: PCL link monitor pcldaemon(lM) 

cp, In, mv: copy, link or move files cp(l) 

link: link to a file link(2) 

protocol, dmc: communications link with built-in DDCMP dmc(7) 

lint: a C program checker lint(l) 

Is: list contents of directory ls(l) 

for a file system, ff: list file names and statistics ff(lM) 

nlist: get entries from name list nlist(3C) 

nm: print name list nm.pdp(l) 

nm: print name list of common object file nm(l) 

by fsck. checklist: list of file systems processed checklist (4) 

handle variable argument list, varargs: varargs(5) 

output of a varargs argument list, /print formatted vprintf(3S) 

output of a varargs argument list, /print formatted vprintf(3X) 

xargs: construct argument list(s) and execute command xargs(l) 

files, cp, In, mv: copy, link or move cp(l) 

romboot: special ROM bootstrap loaders romboot(8) 

index: return location of Fortran substring index(3F) 

end: last locations in program end(3C) 

memory, plock: lock process, text, or data in plock(2) 

intrinsic function, log: Fortran natural logarithm .... log(3F) 

gamma: log gamma function gamma (3M) 

newgrp: log in to a new group newgrp(l) 

logarithm intrinsic function, log 10: Fortran common logl0(3F) 

loglO: Fortran common logarithm intrinsic function logl0(3F) 

log: Fortran natural logarithm intrinsic function log(3F) 

functions, exp: exponential, logarithm, power, square root exp(3M) 

errpt: process a report of logged errors errpt(lM) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

cuserid: get character login name of the user cuserid(3S) 

logname: return login name of user logname(3X) 

passwd: change login password passwd(l) 

login: sign on login ( 1 ) 

setting up an environment at login time, profile: profile(4) 

logname: get login name logname(l) 

user, logname: return login name of .... logname(3X) 
string. a641: convert between long integer and base-64 ASCII .... a641(3C) 

sputl: access long integer data in a/ sputl(3X) 

between 3-byte integers and long integers. 13tol: convert 13tol(3C) 
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for an object library, lorder: find ordering relation lorder(l) 

nice: run a command at low priority nice(l) 

requests to an LP line/ lp, cancel: send/cance! lp(l) 

send/cancel requests to an LP line printer, lp, cancel: lp(l) 

lp: line printer lp(7) 

enable: enable/disable LP printers enable(l) 

Ipsched: start/stop the LP request scheduler lpsched(lM) 

accept: allow/prevent LP requests accept(lM) 

lpadmin: configure the LP spooling system Ipadmin(lM) 

lpstat: print LP status information lpstat(l) 

spooling system, lpadmin: configure the LP lpadmin(lM) 

request scheduler Ipsched: start/stop the LP Ipsched (1M) 

information, lpstat: print LP status lpstat(l) 

directory. Is: list contents of ls(l) 

update, lsearch: linear search and lsearch(3C) 

pointer, lseek: move read/write file lseek(2) 

vlx: VAX- 1 1/780 LSI console floppy interface vlx(lM) 

m4: macro processor m4(l) 

vpm: Virtual Protocol Machine. . . . vpm(7) 

for the virtual protocol machine, vpmc: compiler vpmc.dec(lM) 

values: machine-dependent values values(5) 

/access long integer data in a machine-independent fashion sputl(3X) 

m4: macro processor m4(l) 

program, tapeboot: magnetic tape bootstrap tapeboot(8) 

ht: TU16/TE16 magnetic tape interface ht(7) 

tm:TMll/TU10 magnetic tape interface tm.pdp(7) 

ts: TS1 1 magnetic tape interface tsl 1 (7) 

tu78: TU78 magnetic tape interface tu78(7) 

send mail to users or read mail, mail: mail(l) 

readmail, mail: send mail to users or mail(l) 

mail: send mail to users or read mail mail(l) 

processing system, mailx: interactive message mailx(l) 

malloc: main memory allocator. malloc(3C) 

malloc: fast main memory allocator malloc(3X) 

regenerate groups of/ make: maintain, update, and make(l) 

ar: archive and library maintainer ar.pdp(l) 

ar: archive and library maintainer for portable/ . . . . . . . ar(l) 

intro: introduction to maintenance commands intro(lM) 

intro: introduction to system maintenance procedures intro(8) 

SCCS file, delta: make a delta (change) to an delta (1) 

mkdir: make a directory mkdir(l) 

or ordinary file, mknod: make a directory, or a special mknod(2) 

mktemp: make a unique file name mktemp(3C) 

regenerate groups of/ make: maintain, update, and make(l) 

banner: make posters banner(l) 

key. makekey: generate encryption makekey(l) 

allocator, malloc: fast main memory malloc(3X) 

malloc: main memory allocator malloc(3C) 

manual, man: print entries in this man(l) 

tsearch: manage binary search trees tsearch(3C) 

hsearch: manage hash search tables hsearch(3C) 

shl: shell layer manager shl(l) 

records, fwtmp: manipulate connect accounting .... fwtmp(lM) 

of a file function, ldlread: manipulate line number entries .... ldlread(3X) 

floating-point/ frexp: manipulate parts of frexp(3C) 

man: print entries in this manual man(l) 

ascii: map of ASCII character set ascii (5) 

files, diffmk: mark differences between diffmk(l) 

umask: set file-creation mode mask umask(l) 

set and get file creation mask, umask: umask(2) 

table, master: master device information master.dec(4) 

information table, master: master device master. dec (4) 

regular expression compile and match routines, regexp: regexp(5) 

math: math functions and constants math (5) 
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constants. 

function. 

multiple-access-user-space/ 
functions, 
max: Fortran 

maze: generate a 
accounting. 
rp07: RP07 non-removable 


malloc: main 
malloc: fast main 
shmctl: shared 
mem: core 
/(shared 
memccpy: 
shmop: shared 
lock process, text, or data in 
shmget: get shared 
sort: sort and/or 
files, acctmerg: 
file paste: 

msgctl: 
msgop: 
mailx: interactive 
ipcrm: remove a 
msgget: get 
mesg: permit or deny 
perror: system error 
kmc: KMC-1 1B/KMS1 1 
functions, 
min: Fortran 
and commands, 
boot image. 


special or ordinary file. 

name. 

mill: 

table. 

intrinsic functions, 
chmod: change 
umask: set file-creation 
chmod: change 
dmk: DM11 -BA 
dmkset: connect DM 11 -BA 
getty: set terminal type, 
bs: a compiler/interpreter for 
touch: update access and 
utime: set file access and 
pcldaemon: PCL link 
profile, 
uusub: 

mount: 
system, mount: 

system, 
setmnt: establish 
mnttab: 


math: math functions and 
matherr: error-handling . . 

maus: 

max: Fortran maximum-value 
maximum-value functions, 
maze: generate a maze. . . 

maze 

mclock: return Fortran time 
medium moving-head disk. . 

mem: core memory 

memccpy: memory operations. 

memory allocator 

memory allocator 

memory control operations. . 

memory 

memory) operations 

memory operations 

memory operations 

memory, plock: 

memory segment 

merge files 

merge or add total accounting 
merge same lines of several . 
mesg: permit or deny messages 
message control operations. . 

message operations 

message processing system. . 

message queue 

message queue 

messages 

messages 

microprocessor 

min: Fortran minimum-value 
minimum-value functions, 
mk: how to remake the system 
mkboot: convert a.out file to 
mkdir: make a directory. . . 
mkfs: construct a file system, 
mknod: build special file. . . 
mknod: make a directory, or a 
mktemp: make a unique file 
mill: ML11 solid-state disk. 
ML1 1 solid-state disk. . . . 
mnttab: mounted file system 
mod: Fortran remaindering . 

mode 

mode mask 

mode of file 

modem control multiplexor. . 
modems to KMC 1 1 -B . . . 
modes, speed, and line/ . . 
modest-sized programs. . . 
modification times of a file. . 

modification times 

monitor 

monitor: prepare execution . 
monitor uucp network. . . . 

moo: guessing game 

mount a file system 

mount and dismount file . . 
mount: mount a file system. . 
mount: mount and dismount file 

mount table 

mounted file system table. . . 


math (5) 

matherr(3M) 

maus(2) 

max(3F) 

max(3F) 

maze (6) 

maze (6) 

mclock(3F) 

rp07(7) 

mem(7) 

memory(3C) 

malloc(3C) 

malloc(3X) 

shmctl (2) 

mem (7) 

maus(2) 

memory(3C) 

shmop(2) 

plock (2) 

shmget (2) 

sort(l) 

acctmerg (1M) 

paste(l) 

mesg(l) 

msgctl (2) 

msgop (2) 

mailx(l) 

ipcrm(l) 

msgget (2) 

mesg(l) 

perror(3C) 

kmc (7) 

min(3F) 

min(3F) 

mk(8) 

mkboot (1M) 
mkdir(l) 
mkfs(l M) 
mknod (1M) 
mknod (2) 
mktemp(3C) 
mlll.pdp(7) 
mil 1 ,pdp(7) 
mnttab (4) 
mod(3F) 
chmod (1) 
umask(l) 
chmod (2) 
dmk(7) 
dmkset (1M) 
getty (1M) 
bs(l) 
touch(l) 
utime (2) 
pcldaemon(lM) 
monitor(3C) 
uusub(lM) 
moo (6) 
mount (2) 
mount (1M) 
mount (2) 
mount(lM) 
setmnt(lM) 
mnttab(4) 
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mvdir: move a directory mvdir(lM) 

cp. In, mv: copy, link or move files cp(l) 

lseek: move read/write file pointer lseek(2) 

hm: RM05 moving-head disk hm(7) 

hp: RP04/RP05/RP06 moving-head disk hp(7) 

rm80: RM80 moving-head disk rm80(7) 

RP07 non-removable medium moving-head disk. rp07: rp07(7) 

rp: RP-1 1/RP03 moving-head disk rp.pdp(7) 

gd: general driver for moving-head disks gd(7) 

operations, msgctl: message control msgctl(2) 

msgget: get message queue msgget(2) 

msgop: message operations msgop(2) 

(shared memory)/ maus: multiple-access-user-space maus(2) 

DH-11 asynchronous multiplexers. /DZ-1 1/KMC-l IB, . . . dz(7) 

dmk: DM1 1 -BA modem control multiplexor dmk(7) 

cp, In, mv: copy, link or move files cp(l) 

mvdir: move a directory mvdir(lM) 

function, log: Fortran natural logarithm intrinsic log(3F) 

i-numbers. ncheck: generate names from ncheck(lM) 

anint: Fortran nearest integer functions round(3F) 

PCL network, net: execute a command on the .... net(lC) 

execute a command on the PCL network, net: net (1C) 

commands, stat: statistical network useful with graphical stat(lG) 

uusub: monitor uucp network uusub(lM) 

a text file, newform: change the format of .... newform(l) 

newgrp: log in to a new group newgrp(l) 

news: print news items news(l) 

news: print news items news(l) 

process, nice: change priority of a nice(2) 

priority, nice: run a command at low nice(l) 

nl: line numbering filter. nl(l) 

list, nlist: get entries from name nlist(3C) 

nm: print name list nm.pdp(l) 

object file, nm: print name list of common . . . . nm(l) 

hangups and quits, nohup: run a command immune to . . . nohup(l) 

setjmp: non-local goto setjmp(3C) 

moving-head/ rp07: RP07 non-removable medium rp07(7) 

null: the null file null(7) 

null: the null file null(7) 

nl: line numbering filter nl(l) 

graphics: access graphical and numerical commands graphics(lG) 

ldfcn: common object file access routines ldfcn(4) 

dump selected parts of an object file, dump: dump(l) 

ldopen: open a common object file for reading ldopen(3X) 

ldclose: close a common object file ldclose(3X) 

the file header of a common object file, ldfhread: read Idfhread(3X) 

indexed/named section of an object file, /seek to an ldsseek(3X) 

the symbol table of a common object file, /seek to ldtbseek(3X) 

number entries in a common object file, linenum: line linenum(4) 

nm: print name list of common object file nm(l) 

information for a common object file, /relocation reloc(4) 

section header for a common object file, scnhdr: scnhdr(4) 

format, syms: common object file symbol table syms(4) 

file header for common object files, filehdr: filehdr(4) 

directories, cpset: install object files in binary cpset(lM) 

Id: link editor for common object files Id(l) 

print section sizes of common object files, size: size(l) 

size: print sizes of object files size.pdp(l) 

find ordering relation for an object library, lorder: lorder(l) 

formats, convert: convert object/archive files to common .... convert(l) 

sky: obtain ephemerides sky(6) 

od: octal dump od(l) 

od: octal dump od(l) 

reading, ldopen: open a common object file for ldopen (3X) 
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fopen: open a stream fopen(3S) 

dup: duplicate an open file descriptor dup(2) 

open: open for reading or writing open (2) 

writing, open: open for reading or open(2) 

prf: operating system profiler prf(7) 

prfld: operating system profiler profiler(lM) 

750ops: VAX- 11/750 console operations 750ops(8) 

780ops: VAX-1 1/780 console operations 780ops(8) 

/(shared memory) operations maus(2) 

memccpy: memory operations memory(3C) 

msgctl: message control operations msgctl(2) 

msgop: message operations msgop(2) 

semctl: semaphore control operations semctl(2) 

semop: semaphore operations semop(2) 

shmctl: shared memory control operations shmctl(2) 

shmop: shared memory operations shmop(2) 

strcat: string operations string(3C) 

join: relational database operator join(l) 

dcopy: copy file systems for optimal access time dcopy(lM) 

CRT screen handling and optimization package, curses: curses(3X) 

vector, getopt: get option letter from argument getopt(3C) 

file, ldohseek: seek to the optional file header of a ldohseek(3X) 

fcntl: file control options fcntl(5) 

stty: set the options for a terminal stty(l) 

getopt: parse command options getopt(l) 

functions, and, or, xor, not: Fortran boolean bool (3 F) 

object library, lorder: find ordering relation for an lorder(l) 

a directory, or a special or ordinary file, mknod: make mknod(2) 

dial: establish an out-going terminal line/ dial(3C) 

assembler and link editor output, a.out: common a.out(4) 

assembler and link editor output, a.out: PDP-1 1 a.out.pdp(4) 

vprintf: print formatted output of a varargs argument/ .... vprintf(3S) 

vprintf: print formatted output of a varargs argument/ .... vprintf(3X) 

printf: print formatted output printf(3S) 

acctdisk: overview of accounting acct(lM) 

chown: change owner and group of a file chown(2) 

chown: change owner or group chown(l) 

files, pack: compress and expand pack(l) 

handling and optimization package, curses: CRT screen curses(3X) 

sal: system activity report package sar(lM) 

standard buffered input/output package, stdio: stdio(3S) 

interprocess communication package, ftok: standard stdipc(3C) 

check RP06 and RM05 disk packs, format: format and/or format (1M) 

4014 terminal. 4014: paginator for the TEKTRONIX . . . 4014(1) 

interface, pci: parallel communications link pci (7) 

process, process group, and parent process IDs. /get getpid(2) 

getopt: parse command options getopt(l) 

passwd: change login password passwd(l) 

passwd: password file passwd (4) 

getpwent: get password file entry getpwent(3C) 

putpwent: write password file entry putpwent(3C) 

passwd: password file passwd (4) 

getpass: read a password getpass(3C) 

passwd: change login password passwd(l) 

pwck: password/group file checkers pwck(lM) 

several file paste: merge same lines of pasted ) 

dirname: deliver portions of path names, basename basename(l) 

directory, getcwd: get path-name of current working getcwd(3C) 

grep: search a file for a pattern grep(l) 

processing language, awk: pattern scanning and awk(l) 

signal, pause: suspend process until pause(2) 

pcldaemon: PCL link monitor pcldaemon(lM) 

net: execute a command on the PCL network net(lC) 

link interface, pci: parallel communications pci (7) 
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pcldaemon: PCL link monitor pcldaemon(lM) 

fscv: convert files between PDP-1 1 and VAX-1 1/780 systems. . . fscv.vax(lM) 

as: assembler for PDP-11 as.pdp(l) 

editor output, a.out: PDP-1 1 assembler and link a.out.pdp(4) 

/convert archive files from PDP-1 1 to common format arcv.pdp(l) 

value about processor type, pdpl 1, vax: provide truth machid(l) 

mesg: permit or deny messages mesg(l) 

format, acct: per-process accounting file acct(4) 

acctcms: command summary from per-process accounting/ acctcms(lM) 

perror: system error messages perror(3C) 

terminals, pg: file perusal filter for soft-copy Pg(l) 

soft-copy terminals, pg: file perusal filter for pg(l) 

split: split a file into pieces split (l) 

channel, pipe: create an interprocess pipe(2) 

tee: pipe fitting tee(l) 

popen: initiate pipe to/from a process popen(3S) 

data in memory, plock: lock process, text, or piock(2) 

plot: graphics interface plot(4) 

subroutines, plot: graphics interface plot(3X) 

images, pnch: file format for card pnch(4) 

fseek: reposition a file pointer in a stream fseek(3S) 

lseek: move read/write file pointer lseek(2) 

process, popen: initiate pipe to/from a popen (3S) 

and library maintainer for portable archives, /archive ar(l) 

basename, dirname: deliver portions of path names basename(l) 

functions, dim: positive difference intrinsic dim(3F) 

banner: make posters banner(l) 

exp: exponential, logarithm, power, square root functions exp(3M) 

pr: print files pr(l) 

function, dprod: double precision product intrinsic dprod(3F) 

monitor: prepare execution profile monitor(3C) 

cpp: the C language preprocessor cpp(l) 

unget: undo a previous get of an SCCS file unget(l) 

profiler, prf: operating system prf(7) 

profiler, prfld: operating system profiler(lM) 

graphical/ gps: graphical primitive string, format of gps(4) 

types: primitive system data types types (5) 

prs: print an SCCS file prs(l) 

date: print and set the date dated) 

cal: print calendar cal(l) 

of a file, sum: print checksum and block count .... sum(l) 

editing activity, sact: print current SCCS file sact(l) 

man: print entries in this manual man(l) 

cat: concatenate and print files cat(l) 

pr: print files p r (l) 

varargs argument/ vprintf: print formatted output of a vprintf(3S) 

varargs argument/ vprintf: print formatted output of a vprintf(3X) 

printf: print formatted output printf(3S) 

information bdblk: print, initialize, update bad bdblk(lM) 

lpstat: print LP status information lpstat(l) 

nm: print name list nm.pdp(l) 

object file, nm: print name list of common nm(l) 

system, uname: print name of current UNIX uname(l) 

news: print news items news(l) 

file(s). acctcom: search and print process accounting acctcom(l) 

object files, size: print section sizes of common size(l) 

size: print sizes of object files size.pdp(l) 

names, id: print user and group IDs and id(l) 

vpmsave: save and print VPM event traces vpmsave(lM) 

requests to an LP line printer, /cancel: send/cancel lp(l) 

lp: line printer lp(7) 

vpr: Versa tec printer spooler vpr(l) 

vp: Versatec printer vp.pdp(7) 

enable: enable/disable LP printers enabled) 
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output, printf: print formatted printf(3S) 

nice: run a command at low priority nice(l) 

nice: change priority of a process nice(2) 

errors, errpt: process a report of logged errpt(lM) 

acct: enable or disable process accounting acct(2) 

acctprcl: process accounting acctprc(lM) 

acctcom: search and print process accounting file(s) acctcom(l) 

alarm: set a process alarm clock alarm (2) 

times, times: get process and child process times(2) 

initialization, init: process control init(lM) 

timex: time a command; report process data and system/ timex(l) 

exit: terminate process exit (2) 

fork: create a new process fork (2) 

process/ getpid: get process, process group, and parent getpid(2) 

setpgrp: set process group ID setpgrp(2) 

process group, and parent process IDs. /get process getpid(2) 

inittab: script for the init process inittab(4) 

kill: terminate a process kill (1 ) 

nice: change priority of a process nice(2) 

kill: send a signal to a process or a group of/ kill (2) 

popen: initiate pipe to/from a process popen(3S) 

parent process/ getpid: get process, process group, and getpid (2) 

ps: report process status ps(l) 

memory, plock: lock process, text, or data in plock(2) 

times: get process and child process times times(2) 

wait: wait for child process to stop or terminate wait (2) 

ptrace: process trace ptrace(2) 

pause: suspend process until signal pause(2) 

wait: await completion of process wait(l) 

list of file systems processed by fsck. checklist: checklist (4) 

to a process or a group of processes, /send a signal kill (2) 

killall: kill all active processes killall(lM) 

structure, fuser: identify processes using a file or file fuser(lM) 

awk: pattern scanning and processing language awk(l) 

shutdown: terminate all processing shutdown (1M) 

mailx: interactive message processing system mailx(l) 

m4: macro processor m4(l) 

vax: provide truth value about processor type, pdpl 1, machid(l) 

dprod: double precision product intrinsic function dprod(3F) 

prof: display profile data prof(l) 

function, prof: profile within a prof(5) 

profile, profil: execution time profil(2) 

prof: display profile data prof(l) 

monitor: prepare execution profile monitor(3C) 

profil: execution time profile profil (2) 

environment at login time, profile: setting up an profile (4) 

prof: profile within a function prof(5) 

prf: operating system profiler prf(7) 

prfld: operating system profiler profiler(lM) 

sadp: disk access profiler sadp(lM) 

standard/restricted command programming language, /the sh(l) 

link with built-in DDCMP protocol, dmc: communications .... dmc(7) 

vpm: Virtual Protocol Machine vpm(7) 

vpmc: compiler for the virtual protocol machine vpmc.dec(lM) 

arithmetic: provide drill in number facts arithmetic(6) 

processor type, pdpl 1, vax: provide truth value about machid(l) 

true: provide truth values true(l) 

prs: print an SCCS file prs(l) 

ps: report process status ps(l) 

sxt: pseudo-device driver sxt(7) 

/generate uniformly distributed pseudo-random numbers drand48(3C) 

ptrace: process trace ptrace(2) 

stream, ungetc: push character back into input .... ungetc(3S) 

a stream, putc: put character or word on .... putc(3S) 
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environment, putenv: change or add value to .... putenv(3C) 

entry, putpwent: write password file putpwent(3C) 

stream, puts: put a string on a puts(3S) 

checkers, pwck: password/group file pwck(lM) 

pwd: working directory name pwd(l) 

Survey, qasurvey: Quality Assurance qasurvey(lM) 

qsort: quicker sort qsort(3C) 

qasurvey: Quality Assurance Survey qasurvey (1M) 

tput: query terminfo database tput(l) 

ipcrm: remove a message queue ipcrm(l) 

msgget: get message queue ' msgget(2) 

qsort: quicker sort qsort (3C) 

command immune to hangups and quits, nohup: run a nohup(l) 

quiz: test your knowledge quiz(6) 

generator, rand: simple random-number rand(3C) 

irand: random number generator rand(3F) 

rand: simple random-number generator rand(3C) 

fsplit: split f77, ratfor, or efl files fsplit Cl) 

dialect, ratfor: rational Fortran ratfor(l) 

ratfor: rational Fortran dialect ratfor(l) 

getpass: read a password getpass(3C) 

entry of a file, ldtbread: read an indexed symbol table . .... ldtbread(3X) 

header of a file, ldshread: read an indexed/named section .... ldshread(3X) 

read: read from file read (2) 

mail: send mail to users or read mail mail(l) 

line: read one line line(l) 

read: read from file read (2) 

ldahread: read the archive header ldahread(3X) 

common object file, ldfhread: read the file header of a ldfhread(3X) 

open a common object file for reading, ldopen: ldopen(3X) 

open: open for reading or writing open (2) 

lseek: move read/write file pointer lseek (2) 

specify what to do upon receipt of a signal, signal: signal(2) 

/specify Fortran action on receipt of a system signal signal(3F) 

from per-process accounting records, /command summary . .... acctcms(lM) 

errdead: extract error records from dump errdead(lM) 

manipulate connect accounting records, fwtmp: fwtmp(lM) 

tape, free: recover files from a backup frec(lM) 

ed, red: text editor ed(l) 

regular expression, regemp: compile and execute regcmp(3X) 

compile, regemp: regular expression regcmp(l) 

make: maintain, update, and regenerate groups of programs make(l) 

compile and match routines, regexp: regular expression regexp(5) 

match routines, regexp: regular expression compile and .... regexp(5) 

regemp: regular expression compile regcmp(l) 

regemp: compile and execute regular expression regcmp(3X) 

sorted files, comm: select or reject lines common to two comm(l) 

lorder: find ordering relation for an object/ lorder(l) 

join: relational database operator join(l) 

for a common object file, reloc: relocation information reloc(4) 

strip: remove symbols and relocation bits strip.pdp(l) 

section of a/ ldrseek: seek to relocation entries of a ldrseek(3X) 

common object file, reloc: relocation information for a reloc(4) 

floor: floor, ceiling, remainder, absolute value/ floor(3M) 

functions, mod: Fortran remaindering intrinsic mod(3F) 

commands, mk: how to remake the system and mk(8) 

calendar: reminder service calendar (1) 

rje: RJE (Remote Job Entry) to IBM rje(8) 

ct: spawn getty to a remote terminal ct(lC) 

file, rmdel: remove a delta from an SCCS .... rmdel(l) 

ipcrm: remove a message queue ipcrm(l) 

unlink: remove directory entry unlink (2) 

rm: remove files or directories rm(l) 

bits, strip: remove symbols and relocation .... strip.pdp(l) 
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uniq: report repeated lines in a file uniq(l) 

clock: report CPU time used clock(3C) 

communication/ ipcs: report inter-process ipcs(l) 

blocks, df: report number of free disk df(lM) 

errpt: process a report of logged errors errpt(lM) 

sal: system activity report package sar(lM) 

timex: time a command; report process data and system/ .... timex(l) 

ps: report process status ps(l) 

file, uniq: report repeated lines in a uniq(l) 

rjestat: RJE status report rjestat(lC) 

trenter: enter a trouble report trenter(l) 

sar: system activity reporter sar(l) 

stream, fseek: reposition a file pointer in a fseek(3S) 

lpsched: start/stop the LP request scheduler lpsched(lM) 

accept: allow/prevent LP requests accept (1M) 

lp, cancel: send/cancel requests to an LP line/ lp(l) 

symbol table/ ldgetname: retrieve symbol name for file ldgetname(3X) 

argument, getarg: return Fortran command-line getarg(3F) 

variable, getenv: return Fortran environment getenv(3F) 

accounting, mclock: return Fortran time mclock(3F) 

abs: return integer absolute value abs(3C) 

string, len: return length of Fortran len(3F) 

substring, index: return location of Fortran index(3F) 

logname: return login name of user logname(3X) 

name, getenv: return value for environment getenv(3C) 

stat: data returned by stat system call stat(5) 

reversi: a game of dramatic reversals reversi(6) 

col: filter reverse line-feeds col(l) 

reversals, reversi: a game of dramatic reversi (6) 

creat: create a new file or rewrite an existing one creat(2) 

file, rf: RF 11 /RSI 1 fixed-head disk .... rf.pdp(7) 

file, rf: RF1 1/RSI 1 fixed-head disk rf.pdp(7) 

disk file, hs: RH11/RJS03-RJS04 fixed-head . . . hs.pdp(7) 

gather files and/or submit RJE jobs, send: send(lC) 

rje: RJE (Remote Job Entry) to IBM. . . . rje(8) 

IBM. rje: RJE (Remote Job Entry) to ... . rje(8) 

rjestat: RJE status report rjestat(lC) 

rjestat: RJE status report rjestat (1 C) 

rk: RK.-1 1/RK03 or RK05 disk rk.pdp(7) 

rk: RK-11/RK03 or RK05 disk rk.pdp(7) 

rk: RK-11/RK03 or RK05 disk rk.pdp(7) 

rl: RL-1 1/RL01 disk rl(7) 

rl: RL-1 1/RL01 disk rl(7) 

directories, rm: remove files or rm(l) 

format and/or check RP06 and RM05 disk packs, format: format(lM) 

hm: RM05 moving-head disk hm(7) 

rm80: RM80 moving-head disk rm80(7) 

rm80: RM80 moving-head disk rm80(7) 

SCCS file, rmdel: remove a delta from an .... rmdel(l) 

romboot: special ROM bootstrap loaders romboot(8) 

loaders, romboot: special ROM bootstrap . . . romboot(8) 

chroot: change root directory chroot(2) 

chroot: change root directory for a command chroot(lM) 

logarithm, power, square root functions, /exponential, exp(3M) 

sqrt: Fortran square root intrinsic function sqrt(3F) 

hpd: graphical device routines and filters gdev(lG) 

common object file access routines, ldfcn: ldfcn(4) 

expression compile and match routines, regexp: regular regexp(5) 

graphical table of contents routines, toe: toc(lG) 

disk, rp: RP-11/RP03 moving-head .... rp.pdp(7) 

moving-head disk, hp: RP04/RP05/RP06 hp(7) 

format: format and/or check RP06 and RM05 disk packs format(lM) 

moving-head disk. rp07: RP07 non-removable medium rp07(7) 

medium moving-head disk. rp07: RP07 non-removable rp07(7) 
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rp: RP-1 1/RP03 moving-head disk rp.pdp(7) 

nice: run a command at low priority nice(l) 

hangups and quits, nohup: run a command immune to nohup(l) 

runacct: run daily accounting runacct(lM) 

runacct: run daily accounting runacct (1M) 

package, sa 1 : system activity report sar(lM) 

editing activity, sact: print current SCCS file sact(l) 

sadp: disk access profiler sadp(lM) 

sag: system activity graph sag(lG) 

sar: system activity reporter sar(l) 

traces, vpmsave: save and print VPM event vpmsave(lM) 

input, scanf: convert formatted scanf(3S) 

bfs: big file scanner bfs(l) 

language, awk: pattern scanning and processing awk(l) 

stand-alone programs, see: C compiler for scc(l) 

the delta commentary of an SCCS delta, ede: change cdc(l) 

comb: combine SCCS deltas comb(l) 

make a delta (change) to an SCCS file, delta: delta(l) 

sact: print current SCCS file editing activity sact(l) 

get: get a version of an SCCS file get(l) 

prs: print an SCCS file prs(l) 

rmdel: remove a delta from an SCCS file rmdel(l) 

compare two versions of an SCCS file, sccsdiff: sccsdiff(l) 

sccsfile: format of SCCS file sccsfile(4) 

undo a previous get of an SCCS file, unget: unget (l) 

val: validate SCCS file val(l) 

admin: create and administer SCCS files admin(l) 

what: identify SCCS files what(l) 

of an SCCS file, sccsdiff: compare two versions sccsdiff ( 1 ) 

sccsfile: format of SCCS file sccsfile(4) 

start/stop the LP request scheduler lpsched: lpsched(lM) 

common object file, scnhdr: section header for a scnhdr(4) 

optimization/ curses: CRT screen handling and curses(3X) 

vi: screen-oriented editor vi(l) 

inittab: script for the init process inittab(4) 

system initialization shell scripts, bre: brc(lM) 

sdb: symbolic debugger sdb(l) 

program, sdiff: side-by-side difference sdiff(l) 

grep: search a file for a pattern grep(l) 

bsearch: binary search a sorted table bsearch(3C) 

accounting file(s). acctcom: search and print process acctcom(l) 

lsearch: linear search and update lsearch(3C) 

hsearch: manage hash search tables hsearch(3C) 

tsearch: manage binary search trees tsearch(3C) 

jotto: secret word game jotto(6) 

object file, scnhdr: section header for a common scnhdr(4) 

/read an indexed/named section header of a file ldshread(3X) 

to line number entries of a section of a file, /seek ldlseek(3X) 

to relocation entries of a section of a file, /seek ldrseek(3X) 

/seek to an indexed/named section of an object file ldsseek(3X) 

files, size: print section sizes of common object .... size(l) 

sed: stream editor sed(l) 

section of an object/ ldsseek: seek to an indexed/named ldsseek(3X) 

a section of a file, ldlseek: seek to line number entries of ldlseek(3X) 

a section of a file, ldrseek: seek to relocation entries of ldrseek(3X) 

header of a file, ldohseek: seek to the optional file ldohseek(3X) 

common object file, ldtbseek: seek to the symbol table of a Idtbseek(3X) 

shmget: get shared memory segment shmget(2) 

brk: change data segment space allocation brk(2) 

to two sorted files, comm: select or reject lines common comm(l) 

greek: select terminal filter greek(l) 

of a file, cut: cut out selected fields of each line cut(l) 

file, dump: dump selected parts of an object dump(l) 

semctl: semaphore control operations semctl(2) 
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semop: 
semget: get set of 
operations. 


a group of processes, kill: 
submit RJE jobs, 
mail, mail: 
line printer. Ip, cancel: 

stream. 
IDs. setuid, 


login time, profile: 
gettydefs: speed and terminal 
group IDs. 
standard/restricted command/ 
operations, shmctl: 
/multiple-access-user-space 
shmop: 
shmget: get 
system: issue a 
system: issue a 
shl: 

accounting, chargefee: 
brc: system initialization 
command programming/ sh: 

operations. 

segment, 
operations, 
processing, 
program, sdiff: 
intrinsic function. 

login: 

pause: suspend process until 
what to do upon receipt of a 
action on receipt of a system 
on receipt of a system/ 
upon receipt of a signal, 
of processes, kill: send a 
ssignal: software 
lex: generate programs for 
generator, rand: 
function. 

sin: Fortran 
sinh: Fortran hyperbolic 
intrinsic function. 

common object files. 

files. 

size: print section 
size: print 

an interval, 
interval. 

current/ ttyslot: find the 
spline: interpolate 

sno: 

pg: file perusal filter for 
ssignal: 


semaphore operations. . . . 

semaphores 

semctl: semaphore control 
semget: get set of semaphores, 
semop: semaphore operations, 
send a signal to a process or 
send: gather files and/or . . 
send mail to users or read 
send/cancel requests to an LP 
setbuf: assign buffering to a . 
setgid: set user and group 
setjmp: non-local goto. . . . 
setmnt: establish mount table, 
setpgrp: set process group ID. 
setting up an environment at 
settings used by getty. . . . 
setuid, setgid: set user and 

sh: shell, the 

shared memory control . . . 
(shared memory) operations, 
shared memory operations. . 
shared memory segment. . . 
shell command from Fortran. 

shell command 

shell layer manager 

shell procedures for .... 

shell scripts 

shell, the standard/restricted 
shl: shell layer manager. . . 
shmctl: shared memory control 
shmget: get shared memory . 
shmop: shared memory . . . 
shutdown: terminate all . . 
side-by-side difference . . . 
sign: Fortran transfer-of-sign 

sign on 

signal 

signal, signal: specify . . . 
signal, /specify Fortran . . 
signal: specify Fortran action 
signal: specify what to do . . 
signal to a process or a group 

signals 

simple lexical tasks 

simple random-number . . . 
sin: Fortran sine intrinsic . . 
sin: trigonometric functions, 
sine intrinsic function. . . . 
sine intrinsic function. . . . 
sinh: Fortran hyperbolic sine 
sinh: hyperbolic functions, 
size: print section sizes of . . 
size: print sizes of object . . 
sizes of common object files. 

sizes of object files 

sky: obtain ephemerides. . . 
sleep: suspend execution for . 
sleep: suspend execution for . 
slot in the utmp file of the 

smooth curve 

sno: SNOBOL interpreter. . 
SNOBOL interpreter. . . . 

soft-copy terminals 

software signals 


semop (2) 
semget (2) 
semctl (2) 
semget (2) 
semop (2) 
kill (2) 
send (1C) 
mail(l) 
lp(l) 

setbuf(3S) 

setuid (2) 

setjmp(3C) 

setmnt (1M) 

setpgrp (2) 

profile (4) 

gettydefs (4) 

setuid (2) 

sh(l) 

shmctl (2) 

maus(2) 

shmop (2) 

shmget (2) 

system(3F) 

system (3S) 

shl (1 ) 

acctsh(lM) 

brc(lM) 

sh(l) 

shl(l) 

shmctl (2) 

shmget (2) 

shmop (2) 

shutdown (1M) 

sdifr(l) 

sign(3F) 

login(l) 

pause (2) 

signal (2) 

signal (3F) 

signal(3F) 

signal (2) 

kill(2) 

ssignal(3C) 

lex(l) 

rand(3C) 

sin(3F) 

trig(3M) 

sin(3F) 

sinh(3F) 

sinh(3F) 

sinh(3M) 

size(l) 

size.pdp(l) 

size(l) 

size.pdp(l) 

sky (6) 

sleep(l) 

sleep(3C) 

ttyslot (3C) 

spline(lG) 

sno(l) 

sno(l) 

pg(l) 

ssignal (3C) 
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mlll:MLll solid-state disk mlll.pdp(7) 

sort: sort and/or merge files sort(l) 

qsort: quicker sort qsort(3C) 

sort: sort and/or merge files sort(l) 

tsort: topological sort tsort(l) 

or reject lines common to two sorted files, comm: select comm(l) 

bsearch: binary search a sorted table bsearch(3C) 

brk: change data segment space allocation brk(2) 

terminal, ct: spawn getty to a remote ct(lC) 

fspec: format specification in text files fspec(4) 

receipt of a system/ signal: specify Fortran action on signal(3F) 

receipt of a signal, signal: specify what to do upon signal(2) 

/set terminal type, modes, speed, and line discipline getty(lM) 

used by getty. gettydefs: speed and terminal settings gettydefs(4) 

spell: find spelling errors spell ( 1 ) 

spell: find spelling errors spell(l) 

curve, spline: interpolate smooth spline (1G) 

split: split a file into pieces split(l) 

csplit: context split csplit(l) 

files, fsplit: split f77, ratfor, or efl fsplit(l) 

pieces, split: split a file into split(l) 

uuclean: uucp spool directory clean-up uuclean(lM) 

vpr: Versatec printer spooler vpr(l) 

lpadmin: configure the LP spooling system lpadmin(lM) 

data in a machine-independent/ sputl: access long integer sputl(3X) 

intrinsic function, sqrt: Fortran square root sqrt(3F) 

exponential, logarithm, power, square root functions, exp: exp(3M) 

function, sqrt: Fortran square root intrinsic sqrt(3F) 

ssignal: software signals ssignal(3C) 

see: C compiler for stand-alone programs scc(l) 

package, stdio: standard buffered input/output .... stdio(3S) 

communication package, ftok: standard interprocess stdipc(3C) 

programming/ sh: shell, the standard/restricted command sh ( 1 ) 

scheduler lpsched: start/stop the LP request lpsched(lM) 

unixboot: UNIX system startup and boot procedures unixboot(8) 

system call, stat: data returned by stat stat(5) 

stat: get file status stat(2) 

useful with graphical/ stat: statistical network stat(lG) 

stat: data returned by stat system call stat(5) 

with graphical/ stat: statistical network useful stat(lG) 

ff: list file names and statistics for a file system ff(lM) 

ustat: get file system statistics ustat(2) 

lpstat: print LP status information lpstat(l) 

ferror: stream status inquiries ferror(3S) 

control, uustat: uucp status inquiry and job uustat(lC) 

communication facilities status, /report inter-process ipcs(l) 

ps: report process status ps(l) 

rjestat: RJE status report rjestat(lC) 

stat: get file status stat (2) 

input/output package, stdio: standard buffered stdio(3S) 

stime: set time stime(2) 

wait for child process to stop or terminate, wait: wait (2) 

streat: string operations string(3C) 

sed: stream editor sed(l) 

fclose: close or flush a stream fclose(3S) 

fopen: open a stream fopen(3S) 

reposition a file pointer in a stream, fseek: fseek(3S) 

get character or word from a stream, getc: getc(3S) 

gets: get a string from a stream gets(3S) 

put character or word on a stream, putc: putc(3S) 

puts: put a string on a stream puts(3S) 

setbuf: assign buffering to a stream setbuf(3S) 

ferror: stream status inquiries ferror(3S) 

push character back into input stream, ungetc: ungetc(3S) 
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long integer and base-64 ASCII string. a641: convert between a641(3C) 

functions, lge: string comparision intrinsic strcmp(3F) 

convert date and time to string, ctime: ctime(3C) 

floating-point number to string, ecvt: convert ecvt(3C) 

gps: graphical primitive string, format of graphical/ gps(4) 

gets: get a string from a stream gets(3S) 

len: return length of Fortran string len(3F) 

puts: put a string on a stream puts(3S) 

strcat: string operations string(3C) 

number, strtod: convert string to double-precision strtod(3C) 

strtol: convert string to integer strtol(3C) 

relocation bits, strip: remove symbols and strip. pdp(l) 

number information from a/ strip: strip symbol and line strip(l) 

information from a/ strip: strip symbol and line number strip(l) 

double-precision number, strtod: convert string to strtod (3C) 

integer, strtol: convert string to strtol (3C) 

processes using a file or file structure, fuser: identify fuser(lM) 

terminal, stty: set the options for a stty(l) 

another user, su: become super-user or su(l) 

send: gather files and/or submit RJE jobs send(lC) 

intro: introduction to subroutines and libraries intro(3) 

plot: graphics interface subroutines plot(3X) 

return location of Fortran substring, index: index(3F) 

count of a file, sum: print checksum and block .... sum(l) 

du: summarize disk usage du(l) 

accounting/ acctcms: command summary from per-process acctcms(lM) 

sync: update the super block sync(l) 

sync: update super-block sync(2) 

su: become super-user or another user su(l) 

qasurvey: Quality Assurance Survey qasurvey(lM) 

interval, sleep: suspend execution for an sleep(l) 

interval, sleep: suspend execution for sleep(3C) 

pause: suspend process until signal pause(2) 

swab: swap bytes swab(3C) 

swab: swap bytes swab(3C) 

sxt: pseudo-device driver sxt(7) 

information from/ strip: strip symbol and line number strip(l) 

table/ ldgetname: retrieve symbol name for file symbol ldgetname(3X) 

/retrieve symbol name for file symbol table entry ldgetname(3X) 

/compute the index of a symbol table entry of a file ldtbindex(3X) 

ldtbread: read an indexed symbol table entry of a file ldtbread(3X) 

syms: common object file symbol table format syms(4) 

object/ ldtbseek: seek to the symbol table of a common ldtbseek(3X) 

sdb: symbolic debugger sdb(l) 

strip: remove symbols and relocation bits strip. pdp(l) 

symbol table format, syms: common object file syms(4) 

sync: update super-block sync(2) 

sync: update the super block sync(l) 

du: DU-11 synchronous line interface du.pdp(7) 

sysdef: system definition sysdef(lM) 

binary search a sorted table, bsearch: bsearch(3C) 

symbol name for file symbol table entry, /retrieve ldgetname(3X) 

/compute the index of a symbol table entry of a file ldtbindex(3X) 

/read an indexed symbol table entry of a file ldtbread (3X) 

common object file symbol table format, syms: syms(4) 

master device information table, master: master.dec(4) 

mnttab: mounted file system table mnttab(4) 

ldtbseek: seek to the symbol table of a common object file ldtbseek (3X) 

toe: graphical table of contents routines toc(lG) 

setmnt: establish mount table setmnt(lM) 

hsearch: manage hash search tables hsearch(3C) 

tabs: set tabs on a terminal tabs(l) 

tabs: set tabs on a terminal tabs(l) 

a file, tail: deliver the last part of tail(l) 
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function, tan: Fortran tangent intrinsic tan(3F) 

tan: Fortran tangent intrinsic function tan(3F) 

tanh: Fortran hyperbolic tangent intrinsic function tanh(3F) 

tangent intrinsic function, tanh: Fortran hyperbolic tanh(3F) 

tapeboot: magnetic tape bootstrap program tapeboot(8) 

gt: general driver for tape drives gt(7) 

hpio: HP 2645A terminal tape file archiver hpio(l) 

tar: tape file archiver tar(l) 

recover files from a backup tape, free: freed M) 

ht: TU16/TE16 magnetic tape interface ht(7) 

tm: TM1 1 /TUI 0 magnetic tape interface tm.pdp(7) 

ts: TS1 1 magnetic tape interface ts 1 1 (7) 

tu78: TU78 magnetic tape interface tu78(7) 

bootstrap program, tapeboot: magnetic tape tapeboot (8) 

tar: tape file archiver tar(l) 

programs for simple lexical tasks, lex: generate lex(l) 

tee: pipe fitting tee(l) 

4014: paginator for the TEKTRONIX 4014 terminal 4014(1) 

tmpfile: create a temporary file tmpfile(3S) 

tmpnam: create a name for a temporary file. . . . tmpnam(3S) 

terminals, term: conventional names for term (5) 

term: format of compiled term file term (4) 

file., term: format of compiled term .... term (4) 

for the TEKTRONIX 4014 terminal. 4014: paginator 4014(1) 

functions of the DASI 450 terminal. 450: handle special 450(1) 

terminfo: terminal capability data base terminfo(4) 

ct: spawn getty to a remote terminal ct(lC) 

generate file name for terminal, ctermid: ctermid(3S) 

greek: select terminal filter greek(l) 

termio: general terminal interface termio(7) 

tty: controlling terminal interface tty (7) 

dial: establish an out-going terminal line connection dial(3C) 

getty. gettydefs: speed and terminal settings used by gettydefs(4) 

stty: set the options for a terminal stty(l) 

tabs: set tabs on a terminal tabs(l) 

hpio: HP 2645A terminal tape file archiver hpio(l) 

tty: get the name of the terminal tty(l) 

ttyname: find name of a terminal ttyname(3C) 

and line/ getty: set terminal type, modes, speed, getty(lM) 

300: DASI 300 and 300s terminals 300(1) 

handle special functions of HP terminals, hp: hp(l) 

perusal filter for soft-copy terminals, pg: file pg(l) 

term: conventional names for terminals term (5) 

kill: terminate a process kill(l) 

shutdown: terminate all processing shutdown (1M) 

abort: terminate Fortran program abort(3F) 

exit: terminate process exit (2) 

daemon, errstop: terminate the error-logging errstop(lM) 

for child process to stop or terminate, wait: wait wait(2) 

tic: terminfo compiler tic(lM) 

tput: query terminfo database tput(l) 

data base, terminfo: terminal capability terminfo(4) 

interface, termio: general terminal termio(7) 

command, test: condition evaluation test(l) 

vpmtest: test KMC lines vpmtest(lM) 

quiz: test your knowledge quiz(6) 

ed, red: text editor ed(l) 

edit: text editor edit(l) 

ex: text editor ex(l) 

change the format of a text file, newform: newform(l) 

fspec: format specification in text files fspec(4) 

plock: lock process, text, or data in memory plock(2) 

tic: terminfo compiler tic(lM) 

ttt: tic-tac-toe ttt(6) 
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data and system/ timex: time a command; report process .... timex(l) 

time: time a command time(l) 

mclock: return Fortran time accounting mclock(3F) 

execute commands at a later time, at: at(l) 

systems for optimal access time, dcopy: copy file dcopy(lM) 

time: get time time(2) 

profil: execution time profile profil(2) 

up an environment at login time, profile: setting profile (4) 

stime: set time stime(2) 

time: time a command time(l) 

time: get time time(2) 

ctime: convert date and time to string ctime(3C) 

clock: report CPU time used clock(3C) 

process times, times: get process and child times (2) 

update access and modification times of a file, touch: touch(l) 

get process and child process times, times: times(2) 

file access and modification times, utime: set utime(2) 

process data and system/ timex: time a command; report .... timex(l) 

interface, tm: TM1 1 /TUI 0 magnetic tape .... tm.pdp(7) 

interface, tm: TM1 1 /TUI 0 magnetic tape tm.pdp(7) 

file, tmpfile: create a temporary tmpfile(3S) 

temporary file, tmpnam: create a name for a tmpnam(3S) 

contents routines, toe: graphical table of toc(lG) 

popen: initiate pipe to/from a process popen(3S) 

tsort: topological sort tsort(l) 

acctmerg: merge or add total accounting files acctmerg(lM) 

modification times of a file, touch: update access and touch(l) 

toupper: translate characters conv(3C) 

tplot: graphics filters tplot(lG) 

tput: query terminfo database tput(l) 

tr: translate characters tr(l) 

trace: event-tracing driver trace(7) 

ptrace: process trace ptrace(2) 

save and print VPM event traces, vpmsave: vpmsave(lM) 

function, sign: Fortran transfer-of-sign intrinsic sign(3F) 

toupper: translate characters conv(3C) 

tr: translate characters tr (1) 

ftw: walk a file tree ftw(3C) 

tsearch: manage binary search trees tsearch(3C) 

report, trenter: enter a trouble trenter(l) 

sin: trigonometric functions trig(3M) 

trenter: enter a trouble report trenter(l) 

true: provide truth values true(l) 

type, pdpl 1, vax: provide truth value about processor machid(l) 

true: provide truth values trued ) 

interface, ts: TS1 1 magnetic tape tsl 1 (7) 

ts: TS1 1 magnetic tape interface tsl 1(7) 

trees, tsearch: manage binary search .... tsearch(3C) 

tsort: topological sort tsort (l) 

ttt: tic-tac-toe ttt(6) 

interface, tty: controlling terminal tty (7) 

terminal, tty: get the name of the tty(l) 

terminal, ttyname: find name of a ttyname(3C) 

utmp file of the current/ ttyslot: find the slot in the ttyslot(3C) 

interface, ht: TU16/TE 16 magnetic tape ht(7) 

tu78: TU78 magnetic tape interface tu78(7) 

interface. tu78: TU78 magnetic tape tu78(7) 

int: explicit Fortran type conversion ftype(3F) 

file: determine file type file(l) 

truth value about processor type, pdpl 1, vax: provide machid(l) 

getty: set terminal type, modes, speed, and line/ getty(lM) 

types, types: primitive system data types(5) 

types: primitive system data types types (5) 

getpw: get name from UID getpw(3C) 
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limits, ulimit: get and set user ulimit(2) 

creation mask, umask: set and get file umask(2) 

mask, umask: set file-creation mode umask (1) 

umount: unmount a file system umount(2) 

UNIX system, uname: get name of current uname(2) 

UNIX system, uname: print name of current uname(l) 

file, unget: undo a previous get of an SCCS .... unget(l) 

an SCCS file, unget: undo a previous get of unget(l) 

into input stream, ungetc: push character back ungetc(3S) 

drand48: generate uniformly distributed/ drand48(3C) 

a file, uniq: report repeated lines in uniq(l) 

mktemp: make a unique file name mktemp(3C) 

acu: Automatic Call Unit (ACU) interface acu(7) 

units: conversion program units(l) 

and boot procedures, unixboot: UNIX system startup .... unixboot(8) 

execution, uux: UNIX-to-UNIX system command . . . uux(lC) 

uuto: public UNIX-to-UNIX system file copy. . . . uuto(lC) 

entry, unlink: remove directory unlink (2) 

link: exercise link and unlink system calls link(lM) 

umount: unmount a file system umount(2) 

times of a file, touch: update access and modification .... touch(l) 

of programs, make: maintain, update, and regenerate groups .... make(l) 

bdblk: print, initialize, update bad information bdblk(lM) 

lsearch: linear search and update lsearch(3C) 

sync: update super-block sync (2) 

sync: update the super block sync(l) 

du: summarize disk usage du(l) 

stat: statistical network useful with graphical/ stat(lG) 

id: print user and group IDs and names id(l) 

setuid, setgid: set user and group IDs setuid(2) 

crontab: user crontab file crontab(l) 

character login name of the user, cuserid: get cuserid(3S) 

environ: user environment environ (5) 

disk accounting data by user ID. diskusg: generate diskusg(lM) 

getuid: get user IDs getuid(2) 

ulimit: get and set user limits ulimit(2) 

logname: return login name of user logname(3X) 

become super-user or another user.su: su(l) 

the utmp file of the current user, /find the slot in ttyslot(3C) 

write: write to another user write(l) 

mail: send mail to users or read mail mail(l) 

wall: write to all users wall(lM) 

fuser: identify processes using a file or file/ fuser(lM) 

statistics, ustat: get file system ustat(2) 

gutil: graphical utilities gutil(lG) 

modification times, utime: set file access and utime(2) 

utmp: utmp and wtmp entry formats utmp(4) 

getutent: access utmp file entry getut(3C) 

ttyslot: find the slot in the utmp file of the current user ttyslot(3C) 

formats, utmp: utmp and wtmp entry utmp (4) 

clean-up. uuclean: uucp spool directory uuclean(lM) 

uusub: monitor uucp network uusub(lM) 

uuclean: uucp spool directory clean-up uuclean (1M) 

control, uustat: uucp status inquiry and job uustat(lC) 

system copy, uucp: UNIX system to UNIX .... uucp(lC) 

and job control, uustat: uucp status inquiry uustat(lC) 

uusub: monitor uucp network uusub (1M) 

system file copy, uuto: public UNIX-to-UNIX uuto(lC) 

command execution, uux: UNIX-to-UNIX system uux(lC) 

val: validate SCCS file val(l) 

val: validate SCCS file val(l) 

pdpl 1, vax: provide truth value about processor type machid(l) 

abs: return integer absolute value abs(3C) 

abs: Fortran absolute value abs(3F) 
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getenv: return value for environment name getenv(3C) 

ceiling, remainder, absolute value functions, /floor, ........ floor(3M) 

putenv: change or add value to environment putenv(3C) 

values, values: machine-dependent values(5) 

true: provide truth values true(l) 

values: machine-dependent values values(5) 

/print formatted output of a varargs argument list vprintf(3S) 

/print formatted output of a varargs argument list vprintf(3X) 

argument list, varargs: handle variable varargs (5) 

varargs: handle variable argument list varargs (5) 

return Fortran environment variable, getenv: getenv(3F) 

processor type, pdpll, vax: provide truth value about machid(l) 

750ops: VAX-1 1/750 console operations. . . . 750ops(8) 

verification program, vcf: VAX- 1 1/780 configuration vcf(lM) 

780ops: VAX-11/780 console operations. . . . 780ops(8) 

interface, vlx: VAX-1 1/780 LSI console floppy . . . vlx(lM) 

files between PDP-11 and VAX-1 1/780 systems, /convert .... fscv.vax(lM) 

vc: version control vc(l) 

verification program, vcf: VAX-1 1/780 configuration .... vcf(lM) 

option letter from argument vector, getopt: get ... getopt(3C) 

vcf: VAX-11/780 configuration verification program vcf(lM) 

assert: verify program assertion assert(3X) 

vpr: Versatec printer spooler vpr(l) 

vp: Versatec printer vp.pdp(7) 

vc: version control vc(l) 

get: get a version of an SCCS file get(l) 

sccsdiff: compare two versions of an SCCS file sccsdiflf(l) 

vi: screen-oriented editor vi(l) 

vpm: Virtual Protocol Machine vpm(7) 

vpmc: compiler for the virtual protocol machine vpmc.dec(lM) 

floppy interface, vlx: VAX-1 1/780 LSI console vlx(lM) 

with label checking, volcopy: copy file systems volcopy(lM) 

file system: format of system volume fs(4) 

vp: Versatec printer vp.pdp(7) 

vpmset: connect/load VPM drivers vpmset(lM) 

vpmsave: save and print VPM event traces vpmsave(lM) 

vpm: Virtual Protocol Machine vpm(7) 

protocol machine, vpmc: compiler for the virtual vpmc.dec(lM) 

event traces, vpmsave: save and print VPM vpmsave(lM) 

drivers vpmset: connect/load VPM vpmset(lM) 

vpmtest: test KMC lines vpmtest(lM) 

vpr: Versatec printer spooler vpr(l) 

output of a varargs argument/ vprintf: print formatted vpnntf(3S) 

output of a varargs argument/ vprintf: print formatted vpnntf(3X) 

process, wait: await completion of wait(l) 

or terminate, wait: wait for child process to stop wait (2) 

to stop or terminate, wait: wait for child process wait (2) 

ftw: walk a file tree ftw(3C) 

wall: write to all users wall(lM) 

wc: word count wc(l) 

what: identify SCCS files what(l) 

signal, signal: specify what to do upon receipt of a signal (2) 

crashes, crash: what to do when the system crash.dec(8) 

whodo: who is doing what whodo(lM) 

who: who is on the system who(l) 

who: who is on the system who(l) 

whodo: who is doing what whodo (1M) 

cd: change working directory cd(l) 

chdir: change working directory chdir(2) 

get path-name of current working directory, getcwd: getcwd(3C) 

pwd: working directory name pwd(l) 

write: write on a file write (2) 

putpwent: write password file entry putpwent(3C) 

wall: write to all users wall(lM) 
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write: write to another user write (1) 

write: write on a file write (2) 

write: write to another user write(l) 

open: open for reading or writing open (2) 

utmp: utmp and wtmp entry formats utmp(4) 

hunt-the-wumpus. wump: the game of wump(6) 

list(s) and execute command, xargs: construct argument xargs(l) 

functions, and, or, xor, not: Fortran boolean bool(3F) 

jO, jl.jn, yO, yl, yn: Bessel functions bessel(3M) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

compiler-compiler, yacc: yet another yacc(l) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 
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NAME 

intro — introduction to system calls and error numbers 
SYNOPSIS 

#include <errno.h> 

DESCRIPTION 

This section describes all of the system calls. Most of these calls have one or 
more error returns. An error condition is indicated by an otherwise impossible 
returned value. This is almost always — 1; the individual descriptions specify 
the details. An error number is also made available in the external variable 
errno. Errno is not cleared on successful calls, so it should be tested only after 
an error has been indicated. 

Each system call description attempts to list all possible error numbers. The 
following is a complete list of the error numbers and their names as defined in 

<errno.h>. 

1 EPERM Not owner 

Typically this error indicates an attempt to modify a file in some way 
forbidden except to its owner or super-user. It is also returned for 
attempts by ordinary users to do things allowed only to the super-user. 

2 ENOENT No such file or directory 

This error occurs when a file name is specified and the file should exist 
but doesn’t, or when one of the directories in a path name does not 
exist. 

3 ESRCH No such process 

No process can be found corresponding to that specified by pid in kill 
or p trace. 

4 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit), which the user has 
elected to catch, occurred during a system call. If execution is 
resumed after processing the signal, it will appear as if the interrupted 
system call returned this error condition. 

5 EIO I/O error 

Some physical I/O error has occurred. This error may in some cases 
occur on a call following the one to which it actually applies. 

6 ENXIO No such device or address 

I/O on a special file refers to a subdevice which does not exist, or 
beyond the limits of the device. It may also occur when, for example, 
a tape drive is not on-line or no disk pack is loaded on a drive. 

7 E2BIG Arg list too long 

An argument list longer than 5,120 bytes is presented to a member of 
the exec family. 

8 ENOEXEC Exec format error 

A request is made to execute a file which, although it has the appropri- 
ate permissions, does not start with a valid magic number (see 
a.out( 4)). 

9 EBADF Bad file number 

Either a file descriptor refers to no open file, or a read (respectively, 
write) request is made to a file which is open only for writing (respec- 
tively, reading). 

10 ECHILD No child processes 

A wait was executed by a process that had no existing or unwaited-for 
child processes. 
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1 1 EAGAIN No more processes 

A fork failed because the system’s process table is full or the user is 
not allowed to create any more processes. 

12 ENOMEM Not enough space 

During an exec, brk , or sbrk, a program asks for more space than the 
system is able to supply. This is not a temporary condition; the max- 
imum space size is a system parameter. The error may also occur if 
the arrangement of text, data, and stack segments requires too many 
segmentation registers, or if there is not enough swap space during a 
fork. 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden by the protec- 
tion system. 

14 EFAULT Bad address 

The system encountered a hardware fault in attempting to use an argu- 
ment of a system call. 

1 5 ENOTBLK Block device required 

A non-block file was mentioned where a block device was required, 
e.g., in mount. 

16 EBUSY Device or resource busy 

An attempt was made to mount a device that was already mounted or 
an attempt was made to dismount a device on which there is an active 
file (open file, current directory, mounted-on file, active text segment). 
It will also occur if an attempt is made to enable accounting when it is 
already enabled. The device or resource is currently unavailable. 

17 EEXIST File exists 

An existing file was mentioned in an inappropriate context, e.g., link. 

18 EXDEV Cross-device link 

A link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system call to a dev- 
ice; e.g., read a write-only device. 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is required, for exam- 
ple in a path prefix or as an argument to chdirll). 

21 EISDIR Is a directory 

An attempt was made to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument (e.g., dismounting a non-mounted device; men- 
tioning an undefined signal in signal, or kill; reading or writing a file 
for which Iseek has generated a negative pointer). Also set by the 
math functions described in the (3M) entries of this manual. 

23 ENFILE File table overflow 

The system file table is full, and temporarily no more opens can be 
accepted. 

24 EMFILE Too many open files 

No process may have more than 20 file descriptors open at a time. 

25 ENOTTY Not a character device 

An attempt was made to ioctli 2) a file that is not a special character 
device. 
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26 ETXTBSY Text file busy 

An attempt was made to execute a pure-procedure program that is 
currently open for writing. Also an attempt to open for writing a 
pure-procedure program that is being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum file size (1,082,201,088 bytes) 
or ULIMIT; see ulimit(2) . 

28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free space left on the 
device. 

29 ESPIPE Illegal seek 

An Iseek was issued to a pipe. 

30 EROFS Read-only file system 

An attempt to modify a file or directory was made on a device 
mounted read-only. 

31 EMLINK Too many links 

An attempt to make more than the maximum number of links (1000) 
to a file. 

32 EPIPE Broken pipe 

A write on a pipe for which there is no process to read the data. This 
condition normally generates a signal; the error is returned if the signal 
is ignored. 

33 EDOM Math argument 

The argument of a function in the math package (3M) is out of the 
domain of the function. 

34 ERANGE Result too large 

The value of a function in the math package (3M) is not representable 
within machine precision. 

35 ENOMSG No message of desired type 

An attempt was made to receive a message of a type that does not 
exist on the specified message queue; see msgopi 2). 

36 EIDRM Identifier Removed 

This error is returned to processes that resume execution due to the 
removal of an identifier from the file system’s name space (see 
msgctli 2), semctl(2), and shmctlil)) . 

DEFINITIONS 
Process ID 

Each active process in the system is uniquely identified by a positive integer 
called a process ID. The range of this ID is from 1 to 30,000. 

Parent Process ID 

A new process is created by a currently active process; see fork (2). The parent 
process ID of a process is the process ID of its creator. 

Process Group ID 

Each active process is a member of a process group that is identified by a posi- 
tive integer called the process group ID. This ID is the process ID of the group 
leader. This grouping permits the signaling of related processes; see kill (2). 

Tty Group ID 

Each active process can be a member of a terminal group that is identified by a 
positive integer called the tty group ID. This grouping is used to terminate a 
group of related processes upon termination of one of the processes in the 
group; see exit (2) and signal (2) . 
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Real User ID and Real Group ID 

Each user allowed on the system is identified by a positive integer called a real 
user ID. 

Each user is also a member of a group. The group is identified by a positive 
integer called the real group ID. 

An active process has a real user ID and real group ID that are set to the real 
user ID and real group ID, respectively, of the user responsible for the creation 
of the process. 

Effective User ID and Effective Group ID 

An active process has an effective user ID and an effective group ID that are 
used to determine file access permissions (see below). The effective user ID and 
effective group ID are equal to the process’s real user ID and real group ID 
respectively, unless the process or one of its ancestors evolved from a file that 
had the set-user-ID bit or set-group ID bit set; see exec (2). 

Super-user 

A process is recognized as a super-user process and is granted special privileges 
if its effective user ID is 0. 

Special Processes 

The processes with a process ID of 0 and a process ID of 1 are special processes 
and are referred to as procO and procl. 

ProcO is the scheduler. Procl is the initialization process Unit). Procl is the 
ancestor of every other process in the system and is used to control the process 
structure. 

File Descriptor 

A file descriptor is a small integer used to do I/O on a file. The value of a file 
descriptor is from 0 to 19. A process may have no more than 20 file descriptors 
(0-19) open simultaneously. A file descriptor is returned by system calls such 
as opend), or piped). The file descriptor is used as an argument by calls such 
as readd), writed), ioctld), and closed). 

File Name 

Names consisting of 1 to 14 characters may be used to name an ordinary file, 
special file or directory. 

These characters may be selected from the set of all character values excluding 
\0 (null) and the ASCII code for / (slash) . 

Note that it is generally unwise to use *, ?, [, or 1 as part of file names because 
of the special meaning attached to these characters by the shell. See r/z(l). 
Although permitted, it is advisable to avoid the use of unprintable characters in 
file names. 

Path Name and Path Prefix 

A path name is a null-terminated character string starting with an optional 
slash (/), followed by zero or more directory names separated by slashes, 
optionally followed by a file name. 

More precisely, a path name is a null-terminated character string constructed 
as follows; 

<path-name>::=<file-name> | <path-prefix> <file-name>|/ 

< path-prefix > : := < rtprefix > | / < rtprefix > 

< rtprefix > ::= < dirname> / 1 <rtprefix> <dirname>/ 

where <file-name> is a string of 1 to 14 characters other than the ASCII slash 
and null, and <dirname> is a string of 1 to 14 characters (other than the 
ASCII slash and null) that names a directory. 
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If a path name begins with a slash, the path search begins at the root direc- 
tory. Otherwise, the search begins from the current working directory. 

A slash by itself names the root directory. 

Unless specifically stated otherwise, the null path name is treated as if it named 
a non-existent file. 

Directory 

Directory entries are called links. By convention, a directory contains at least 
two links, . and referred to as dot and dot -dot respectively. Dot refers to 
the directory itself and dot-dot refers to its parent directory. 

Root Directory and Current Working Directory 

Each process has associated with it a concept of a root directory and a current 
working directory for the purpose of resolving path name searches. The root 
directory of a process need not be the root directory of the root file system. 

File Access Permissions 

Read, write, and execute/search permissions on a file are granted to a process if 
one or more of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches the user ID of the owner 
of the file and the appropriate access bit of the “owner” portion (0700) 
of the file mode is set. 


The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process matches the 
group of the file and the appropriate access bit of the “group” portion 
(070) of the file mode is set. 

The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process does not 
match the group ID of the file, and the appropriate access bit of the 
“other” portion (07) of the file mode is set. 

Otherwise, the corresponding permissions are denied. 

Message Queue Identifier 

A message queue identifier (msqid) is a unique positive integer created by a 
msgget(2) system call. Each msqid has a message queue and a data structure 
associated with it. The data structure is referred to as msqid ds and contains 
the following members: 


struct 

ipc_perm msgjerm; 

ushort 

msgqnum; 

ushort 

msgqbytes; 

ushort 

msglspid; 

ushort 

msgjrpid; 

timet 

msgstime; 

timet 

msg_rtime; 

timet 

msg_ctime; 


/* operation permission struct »/ 

/» number of msgs on q »/ 

/* max number of bytes on q */ 

/* pid of last msgsnd operation */ 
/* pid of last msgrcv operation */ 
/» last msgsnd time */ 

/* last msgrcv time */ 

/* last change time */ 

/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Msgjerm is an ipc_perm structure that specifies the message operation permis- 
sion (see below) . This structure includes the following members: 


ushort 

cuid; 

/* creator user id */ 

ushort 

cgid; 

/* creator group id */ 

ushort 

uid; 

/» user id */ 

ushort 

gid; 

/* group id */ 

ushort 

mode; 

/• r/w permission */ 
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Msg qnum is the number of messages currently on the queue. Msgqbytes is 
the maximum number of bytes allowed on the queue. Msg_lspid is the process 
id of the last process that performed a msgsnd operation. Msgjrpid is the pro- 
cess id of the last process that performed a msgrcv operation. Msg_stime is the 
time of the last msgsnd operation, msg_rtime is the time of the last msgrcv 
operation, and msgctime is the time of the last ms get l (2) operation that 
changed a member of the above structure. 

Message Operation Permissions 

In the msgop (2) and ms get l (2) system call descriptions, the permission 
required for an operation is given as "{token}", where "token" is the type of per- 
mission needed interpreted as follows: 


00400 

Read by user 

00200 

Write by user 

00060 

Read, Write by group 

00006 

Read, Write by others 


Read and Write permissions on a msqid are granted to a process if one or more 
of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches msgjperm.lcluid in the 
data structure associated with msqid and the appropriate bit of the 
“user” portion (0600) of msgjierm.mode is set. 

The effective user ID of the process does not match msg_perm.[cluid 
and the effective group ID of the process matches msgjerm.lclgid and 
the appropriate bit of the “group” portion (060) of msgjierm.mode is 
set. 

The effective user ID of the process does not match msgjperm.lcluid 
and the effective group ID of the process does not match 
msgjperm.lclgid and the appropriate bit of the “other” portion (06) of 
msgjperm.mode is set. 

Otherwise, the corresponding permissions are denied. 

Semaphore Identifier 

A semaphore identifier (semid) is a unique positive integer created by a 
semget{ 2) system call. Each semid has a set of semaphores and a data struc- 
ture associated with it. The data structure is referred to as semid ds and con- 
tains the following members: 

struct ipcjjerm semjierm; /* operation permission struct */ 

ushort semnsems; /* number of sems in set */ 

timej sem_otime; /* last operation time */ 

time_t sem etime; /* last change time */ 

/• Times measured in secs since */ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 

Semj>erm is an ipc_perm structure that specifies the semaphore operation per- 
mission (see below). This structure includes the following members: 


ushort 

cuid; 

/* creator user id •/ 

ushort 

cgid; 

/* creator group id */ 

ushort 

uid; 

/» user id */ 

ushort 

gid; 

/• group id •/ 

ushort 

mode; 

/* r/a permission «/ 


The value of sem_nsems is equal to the number of semaphores in the set. Each 
semaphore in the set is referenced by a positive integer referred to as a 
sem num. Sem num values run sequentially from 0 to the value of semjisems 
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minus 1 . Sem_otime is the time of the last semop (2) operation, and sem ctime 
is the time of the last semctl (2) operation that changed a member of the above 
structure. 


A semaphore is a data structure that contains the following members: 


ushort semval; 
short sempid; 
ushort semncnt; 
ushort semzcnt; 


/» semaphore value */ 

/* pid of last operation */ 

/* # awaiting semval > cval */ 
/* # awaiting semval = 0 */ 


Semval is a non-negative integer. Sempid is equal to the process ID of the last 
process that performed a semaphore operation on this semaphore. Semncnt is a 
count of the number of processes that are currently suspended awaiting this 
semaphore’s semval to become greater than its current value. Semzcnt is a 
count of the number of processes that are currently suspended awaiting this 
semaphore’s semval to become zero. 


Semaphore Operation Permissions 

In the semop (2) and semctl(2) system call descriptions, the permission 
required for an operation is given as "{token}", where "token" is the type of per- 
mission needed interpreted as follows: 


00400 

Read by user 

00200 

Alter by user 

00060 

Read, Alter by group 

00006 

Read, Alter by others 


Read and Alter permissions on a semid are granted to a process if one or more 
of the following are true: 


The effective user ID of the process is super-user. 

The effective user ID of the process matches sem_perm.[cluid in the 
data structure associated with semid and the appropriate bit of the 
“user” portion (0600) of sem_perm.mode is set. 

The effective user ID of the process does not match sem_perm.[c]uid 
and the effective group ID of the process matches sem_perm.[clgid and 
the appropriate bit of the “group” portion (060) of sem_perm.mode is 
set. 


The effective user ID of the process does not match semjperm.Icluid 
and the effective group ID of the process does not match 
sem jperm.Iclgid and the appropriate bit of the “other” portion (06) of 
sem jerm. mode is set. 

Otherwise, the corresponding permissions are denied. 

Shared Memory Identifier 

A shared memory identifier (shmid) is a unique positive integer created by a 
shmgeti 2) system call. Each shmid has a segment of memory (referred to as a 
shared memory segment) and a data structure associated with it. The data 
structure is referred to as shmid_ds and contains the following members: 


struct 

ipc_perm shm_perm; 

/* operation permission struct */ 

int 

shm_segsz; 

/* size of segment */ 

ushort 

shm_cpid; 

/* creator pid */ 

ushort 

shmjpid; 

/* pid of last operation «/ 

short 

shm_nattch; 

/* number of current attaches */ 

time_t 

shm_atime; 

/* last attach time */ 

time_t 

shm_dtime; 

/« last detach time */ 

timet 

shmctime; 

/* last change time */ 

/* Times measured in secs since */ 
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/» 00:00:00 GMT, Jan. 1, 1970 */ 

Shm jerm is an ipc_perm structure that specifies the shared memory operation 
permission (see below) . This structure includes the following members: 


ushort 

cuid; 

/» creator user id */ 

ushort 

cgid; 

/* creator group id */ 

ushort 

uid; 

/* user id */ 

ushort 

gid; 

/» group id */ 

ushort 

mode; 

/* r/w permission »/ 


Shm_segsz specifies the size of the shared memory segment. Shm_cpid is the 
process id of the process that created the shared memory identifier. Shmjpid is 
the process id of the last process that performed a shmop(2) operation. 
Shm nattch is the number of processes that currently have this segment 
attached. Shmatime is the time of the last shmat operation, shm_dtime is the 
time of the last shmdt operation, and shm_ctime is the time of the last 
shmctl (2) operation that changed one of the members of the above structure. 

Shared Memory Operation Permissions 

In the shmopil) and shmctl (2) system call descriptions, the permission 
required for an operation is given as "{token)", where "token” is the type of per- 
mission needed interpreted as follows: 


00400 

Read by user 

00200 

Write by user 

00060 

Read, Write by group 

00006 

Read, Write by others 


Read and Write permissions on a shmid are granted to a process if one or more 
of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches shm_perm.lcluid in the 
data structure associated with shmid and the appropriate bit of the 
“user” portion (0600) of shm jerm.mode is set. 

The effective user ID of the process does not match shm_perm.[cluid 
and the effective group ID of the process matches shm_perm.lc]gid and 
the appropriate bit of the “group” portion (060) of shm_perm.mode is 
set. 

The effective user ID of the process does not match shm_perm.[c]uid 
and the effective group ID of the process does not match 
shm_perm.[clgid and the appropriate bit of the “other” portion (06) of 
shm jerm.mode is set. 

Otherwise, the corresponding permissions are denied. 

SEE ALSO 

close(2), ioctl (2) , open(2), pipe(2), read (2), write(2), intro(3). 
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NAME 

access — determine accessibility of a file 
SYNOPSIS 

int access (path, amode) 
char *path; 
int amode; 

DESCRIPTION 

Path points to a path name naming a file. Access checks the named file for 
accessibility according to the bit pattern contained in amode, using the real 
user ID in place of the effective user ID and the real group ID in place of the 
effective group ID. The bit pattern contained in amode is constructed as fol- 
lows: 

04 read 

02 write 

01 execute (search) 

00 check existence of file 

Access to the file is denied if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] Read, write, or execute (search) permission is 
requested for a null path name. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a component of the 
path prefix. 

[EROFS] Write access is requested for a file on a read-only 
file system. 

[ETXTBSY] Write access is requested for a pure procedure 
(shared text) file that is being executed. 

[EACCESS] Permission bits of the file mode do not permit 
the requested access. 

[EFAULT] Path points outside the allocated address 
space for the process. 

The owner of a file has permission checked with respect to the “owner” read, 
write, and execute mode bits Members of the file’s group other than the owner 
have permissions checked with respect to the “group” mode bits, and all others 
have permissions checked with respect to the “other” mode bits. 

RETURN VALUE 

If the requested access is permitted, a value of 0 is returned. Otherwise, a 
value of —I is returned and errno is set to indicate the error. 

SEE ALSO 

chmod(2), stat(2). 
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NAME 

acct — enable or disable process accounting 

SYNOPSIS 

int acct (path) 
char *path; 

DESCRIPTION 

Acct is used to enable or disable the system process accounting routine. If the 
routine is enabled, an accounting record will be written on an accounting file 
for each process that terminates. Termination can be caused by one of two 
things: an exit call or a signal; see exit (2) and signal (2) . The effective user ID 
of the calling process must be super-user to use this call. 

Path points to a path name naming the accounting file. The accounting file 
format is given in acct (4) . 

The accounting routine is enabled if path is non-zero and no errors occur dur- 
ing the system call. It is disabled if path is zero and no errors occur during the 
system call. 

Acct will fail if one or more of the following are true: 

[EPERMl The effective user of the calling process is not super-user. 

[EBUSY] An attempt is being made to enable accounting when it is 

already enabled. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] One or more components of the accounting file path name do 
not exist. 

[EACCES] A component of the path prefix denies search permission. 

[EACCES] The file named by path is not an ordinary file. 

[EACCES] Mode permission is denied for the named accounting file. 

[EISDIR] The named file is a directory. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points to an illegal address. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

exit (2), signal (2), acct (4). 
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NAME 

alarm — set a process alarm clock 
SYNOPSIS 

unsigned alarm (sec) 
unsigned sec; 

DESCRIPTION 

Alarm instructs the alarm clock of the calling process to send the signal 
SIGALRM to the calling process after the number of real time seconds specified 
by sec have elapsed; see signal (2). 

Alarm requests are not stacked; successive calls reset the alarm clock of the 
calling process. 

If sec is 0, any previously made alarm request is canceled. 

RETURN VALUE 

Alarm returns the amount of time previously remaining in the alarm clock of 
the calling process. 

SEE ALSO 

pause(2), signal (2). 
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NAME 

brk, sbrk - change data segment space allocation 

SYNOPSIS 

int brk (endds) 
char * endds; 

char *sbrk (incr) 
int incr; 

DESCRIPTION „ , , 

Brk and sbrk are used to change dynamically the amount of space allocated tor 
the calling process’s data segment; see exec (2). The change is made by reset- 
ting the process’s break value and allocating the appropriate amount of space. 
The break value is the address of the first location beyond the end of the data 
segment. The amount of allocated space increases as the break value increases. 
The newly allocated space is set to zero. 

Brk sets the break value to endds and changes the allocated space accordingly. 

Sbrk adds incr bytes to the break value and changes the allocated space 
accordingly. Incr can be negative, in which case the amount of allocated space 
is decreased. 

Brk and sbrk will fail without making any change in the allocated space if one 
or more of the following are true: 

Such a change would result in more space being allocated than is 
allowed by a system-imposed maximum (see ulimitil)). [ENOMEM] 

Such a change would result in the break value being greater than or 
equal to the start address of any attached shared memory segment (see 
shmop(2)). 

RETURN VALUE 

Upon successful completion, brk returns a value of 0 and sbrk returns the old 
break value. Otherwise, a value of -1 is returned and errno is set to indicate 
the error. 

SEE ALSO 

exec(2), shmop(2), ulimit(2). 
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NAME 

chdir — change working directory 
SYNOPSIS 

int chdir (path) 
char “path; 

DESCRIPTION 

Path points to the path name of a directory. Chdir causes the named directory 
to become the current working directory, the starting point for path searches 
for path names not beginning with /. 

Chdir will fail and the current working directory will be unchanged if one or 
more of the following are true: 

[ENOTDIR] A component of the path name is not a directory. 

[ENOENT] The named directory does not exist. 

[EACCES] Search permission is denied for any component of the path 

name. 

[EFAULT] Path points outside the allocated address space of the process. 
RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chroot(2). 
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NAME 

chmod — change mode of file 
SYNOPSIS 

int chmod (path, mode) 
char *path; 
int mode; 

DESCRIPTION 

Path points to a path name naming a file. Chmod sets the access permission 
portion of the named file’s mode according to the bit pattern contained in 
mode. 

Access permission bits are interpreted as follows: 


04000 Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution. 

00400 Read by owner. 

00200 Write by owner. 

00100 Execute (search if a directory) by owner. 

00070 Read, write, execute (search) by group. 

00007 Read, write, execute (search) by others. 

The effective user ID of the process must match the owner of the file or be 
super-user to change the mode of a file. 

If the effective user ID of the process is not super-user, mode bit 01000 (save 
text image on execution) is cleared. 


If the effective user ID of the process is not super-user and the effective group 
ID of the process does not match the group ID of the file, mode bit 02000 (set 
group ID on execution) is cleared. 

If an executable file is prepared for sharing then mode bit 01000 prevents the 
system from abandoning the swap-space image of the program-text portion of 
the file when its last user terminates. Thus, when the next user of the file exe- 
cutes it, the text need not be read from the file system but can simply be 
swapped in, saving time. 

Chmod will fail and the file mode will be unchanged if one or more of the fol- 
lowing are true: 


[ENOTDIRl 

[ENOENT] 

[EACCESl 

[EPERM] 


A component of the path prefix is not a directory. 

The named file does not exist. 

Search permission is denied on a component of the path 
prefix. 

The effective user ID does not match the owner of the file and 
the effective user ID is not super-user. 


[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the allocated address space of the process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chown(2), mknod(2). 
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NAME 

chown — change owner and group of a file 
SYNOPSIS 

int chown (path, owner, group) 

char *path; 

int owner, group; 

DESCRIPTION 

Path points to a path name naming a file. The owner ID and group ID of the 
named file are set to the numeric values contained in owner and group respec- 
tively. 

Only processes with effective user ID equal to the file owner or super-user may 
change the ownership of a file. 

If chown is invoked by other than the super-user, the set-user-ID and set- 
group-ID bits of the file mode, 04000 and 02000 respectively, will be cleared. 

Chown will fail and the owner and group of the named file will remain 
unchanged if one or more of the following are true: 


[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a component of the path 
prefix. 


[EPERM] The effective user ID does not match the owner of the file and 

the effective user ID is not super-user. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the allocated address space of the process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 


SEE ALSO 

chmod(2). 

chown (1) in the UNIX System V User Reference Manual. 
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NAME 

chroot — change root directory 

SYNOPSIS 

int chroot (path) 
char »path; 

DESCRIPTION 

Path points to a path name naming a directory. Chroot causes the named 
directory to become the root directory, the starting point for path searches for 
path names beginning with /. The user’s working directory is unaffected by the 
chroot system call. 

The effective user ID of the process must be super-user to change the root 
directory. 

The .. entry in the root directory is interpreted to mean the root directory itself. 
Thus, .. cannot be used to access files outside the subtree rooted at the root 
directory. 

Chroot will fail and the root directory will remain unchanged if one or more of 
the following are true: 

[ENOTDIR] Any component of the path name is not a directory. 

[ENOENTl The named directory does not exist. 

[EPERM] The effective user ID is not super-user. 

[EFAULT] Path points outside the allocated address space of the process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chdir(2). 
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NAME 

close — close a file descriptor 

SYNOPSIS 

int close (Hides) 
int Hides; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open , dup,fcntl, or pipe sys- 
tem call. Close closes the file descriptor indicated by fildes. 

Close will fail if fildes is not a valid open file descriptor. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

creat (2), dup(2), exec(2), fcntl(2), open(2), pipe(2). 
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NAME 

creat — create a new file or rewrite an existing one 
SYNOPSIS 

int creat (path, mode) 
char *path; 
int mode; 

DESCRIPTION 

Creat creates a new ordinary file or prepares to rewrite an existing file named 
by the path name pointed to by path. 

If the file exists, the length is truncated to 0 and the mode and owner are 
unchanged. Otherwise, the file’s owner ID is set to the effective user ID, of the 
process the group ID of the process is set to the effective group ID, of the pro- 
cess and the low-order 12 bits of the file mode are set to the value of mode 
modified as follows: 

All bits set in the process’s file mode creation mask are cleared. See 
umaski 2). 

The “save text image after execution bit” of the mode is cleared. See 
chmod (2) . 

Upon successful completion, the file descriptor is returned and the file is open 
for writing, even if the mode does not permit writing. The file pointer is set to 
the beginning of the file. The file descriptor is set to remain open across exec 
system calls. See fcntl(2). No process may have more than 20 files open 
simultaneously. A new file may be created with a mode that forbids writing. 

Creat will fail if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] A component of the path prefix does not exist. 

[EACCES] Search permission is denied on a component of the path 

prefix. 

[ENOENT] The path name is null. 

[EACCES] The file does not exist and the directory in which the file is to 

be created does not permit writing. 

[EROFS] The named file resides or would reside on a read-only file sys- 

tem. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being 
executed. 

[EACCES] The file exists and write permission is denied. 

[EISDIR] The named file is an existing directory. 

[EMFILE] Twenty (20) file descriptors are currently open. 

[EFAULT] Path points outside the allocated address space of the process. 

[ENFILE] The system file table is full. 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of -1 is returned and errno is set to indicate 
the error. 

SEE ALSO 

chmod(2), close(2), dup(2), fcntl(2), lseek(2), open(2), read(2), umask(2), 
write (2). 
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NAME 

dup — duplicate an open file descriptor 

SYNOPSIS 

int dup (fildes) 
int fildes; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open , dup, fcntl, or pipe sys- 
tem call. Dup returns a new file descriptor having the following in common 
with the original: 

Same open file (or pipe). 

Same file pointer (i.e., both file descriptors share one file pointer). 

Same access mode (read, write or read/write) . 

The new file descriptor is set to remain open across exec system calls. See 
fcntl (2) . 

The file descriptor returned is the lowest one available. 

Dup will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[EMFILE] Twenty (20) file descriptors are currently open. 

RETURN VALUE 

Upon successful completion a non-negative integer, namely the file descriptor, is 
returned. Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 

SEE ALSO 

creat (2), close (2), exec (2), fcntl (2), open (2), pipe (2). 


- 1 - 



EXEC (2) 


EXEC (2) 


NAME 

execl, execv, execle, execve, execlp, execvp — execute a file 
SYNOPSIS 

int execl (path, argO, argl, argn, 0) 
char *path, *arg0, »argl, *argn; 

int execv (path, argv) 
char »path, »argv[ 1; 

int execle (path, argO, argl, ..., argn, 0, envp) 
char »path, *argO, »argl, ..., *argn, *envp[ 1; 

int execve (path, argv, envp) 
char »path, *argv[ 1, *envp[ 1; 

int execlp (file, argO, argl, ..., argn, 0) 
char »fiie, *argO, *argl, ..., *argn; 

int execvp (file, argv) 
char *file, »argv[ 1; 

DESCRIPTION 

Exec in all its forms transforms the calling process into a new process. The 
new process is constructed from an ordinary, executable file called the new pro- 
cess file. This file consists of a header (see a.outi 4)), a text segment, and a 
data segment. The data segment contains an initialized portion and an unini- 
tialized portion (bss). There can be no return from a successful exec because 
the calling process is overlaid by the new process. 

When a C program is executed, it is called as follows: 

main (argc, argv, envp) 
int argc; 

char “argv, ••envp; 

where argc is the argument count and argv is an array of character pointers to 
the arguments themselves. As indicated, argc is conventionally at least one and 
the first member of the array points to a string containing the name of the file. 

Path points to a path name that identifies the new process file. 

File points to the new process file. The path prefix for this file is obtained by a 
search of the directories passed as the environment line "PATH =" (see 
environ ( 5)). The environment is supplied by the shell (see sh (l)). 

ArgO , argl, ..., argn are pointers to null-terminated character strings. These 
strings constitute the argument list available to the new process. By conven- 
tion, at least argO must be present and point to a string that is the same as 
path (or its last component) . 

Argv is an array of character pointers to null-terminated strings. These strings 
constitute the argument list available to the new process. By convention, argv 
must have at least one member, and it must point to a string that is the same 
as path (or its last component) . Argv is terminated by a null pointer. 

Envp is an array of character pointers to null-terminated strings. These strings 
constitute the environment for the new process. Envp is terminated by a null 
pointer. For execl and execv, the C run-time start-off routine places a pointer 
to the environment of the calling process in the global cell: 

extern char “environ; 

and it is used to pass the environment of the calling process to the new process. 

File descriptors open in the calling process remain open in the new process, 
except for those whose close-on-exec flag is set; see fcntlil). For those file 
descriptors that remain open, the file pointer is unchanged. 
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Signals set to terminate the calling process will be set to terminate the new pro- 
cess. Signals set to be ignored by the calling process will be set to be ignored 
by the new process. Signals set to be caught by the calling process will be set 
to terminate new process; see signal ( 2). 

If the set-user-ID mode bit of the new process file is set (see chmod( 2)), exec 
sets the effective user ID of the new process to the owner ID of the new process 
file. Similarly, if the set-group-ID mode bit of the new process file is set, the 
effective group ID of the new process is set to the group ID of the new process 
file. The real user ID and real group ID of the new process remain the same as 
those of the calling process. 

The shared memory segments attached to the calling process will not be 
attached to the new process (see shmop(2)) ■ 

Profiling is disabled for the new process; see profiKl). 

The new process also inherits the following attributes from the calling process: 

nice value (see nice (.2)) 

process ID 

parent process ID 

process group ID 

semadj values (see semopO.)) 

tty group ID (see exit (2) and signal (2)) 

trace flag (see ptracei 2) request 0) 

time left until an alarm clock signal (see alarm( 2)) 

current working directory 

root directory 

file mode creation mask (see umaski 2)) 

file size limit (see ulimit(2)) 

utime, stime , cutime, and cstime (see times (2)) 

Exec will fail and return to the calling process if one or more of the following 
are true: 


[ENOENT] 

[ENOTDIR] 

[EACCES] 

[EACCES] 

[EACCES] 

[ENOEXECl 

[ETXTBSY] 

[ENOMEMl 

[E2BIGJ 

[EFAULT] 

[EFAULT] 


One or more components of the new process path name of the 
file do not exist. 

A component of the new process path of the file prefix is not a 
directory. 

Search permission is denied for a directory listed in the new 
process file’s path prefix. 

The new process file is not an ordinary file. 

The new process file mode denies execution permission. 

The exec is not an execlp or execvp, and the new process file 
has the appropriate access permission but an invalid magic 
number in its header. 

The new process file is a pure procedure (shared text) file that 
is currently open for writing by some process. 

The new process requires more memory than is allowed by the 
system-imposed maximum MAXMEM. 

The number of bytes in the new process’s argument list is 
greater than the system-imposed limit of 5120 bytes. 

The new process file is not as long as indicated by the size 
values in its header. 

Path, argv, or envp point to an illegal address. 
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RETURN VALUE 

If exec returns to the calling process an error has occurred; the return value 
will be —1 and errno will be set to indicate the error. 

SEE ALSO 

alarm(2), exit(2), fork(2), nice(2), ptrace(2), semop(2), signal(2), times(2), 

ulimit(2), umask(2), a.out(4), environ(5). 

sh(l) in the UNIX System V User Reference Manual. 
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NAME 

exit, _exit — terminate process 
SYNOPSIS 

void exit (status) 
int status; 
void _exit (status) 
int status; 

DESCRIPTION 

Exit terminates the calling process with the following consequences: 

All of the file descriptors open in the calling process are closed. 

If the parent process of the calling process is executing a wait, it is 
notified of the calling process’s termination and the low order eight bits 
(i.e., bits 0377) of status are made available to it; see wait (2). 

If the parent process of the calling process is not executing a wait , the 
calling process is transformed into a zombie process. A zombie process 
is a process that only occupies a slot in the process table. It has no 
other space allocated either in user or kernel space. The process table 
slot that it occupies is partially overlaid with time accounting informa- 
tion (see <sys/proc.h>) to be used by times. 

The parent process ID of all of the calling process’s existing child 
processes and zombie processes is set to 1. This means the initializa- 
tion process (see intro (2)) inherits each of these processes. 

Each attached shared memory segment is detached and the value of 
shm nattach in the data structure associated with its shared memory 
identifier is decremented by 1 . 

For each semaphore for which the calling process has set a semadj 
value (see semopi.2)), that semadj value is added to the semval of the 
specified semaphore. 

If the process has a process, text, or data lock, an unlock is performed 
(see plocki 2)). 

An accounting record is written on the accounting file if the system’s 
accounting routine is enabled; see accf (2). 

If the process ID, tty group ID, and process group ID of the calling pro- 
cess are equal, the SIGHUP signal is sent to each process that has a 
process group ID equal to that of the calling process. 

The C function exit may cause cleanup actions before the process exits. The 
function exit circumvents all cleanup. 

SEE ALSO 

acct(2), intro(2), plock(2), semop(2), signal(2), wait(2). 

WARNING 

See WARNING in signal (2) . 
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NAME 

fcntl — file control 

SYNOPSIS 

#include <fcntl.h> 

int fcntl (Aides, cmd, arg) 
int Aides, cmd, arg; 

DESCRIPTION 

Fcntl provides for control over open files. Fildes is an open file descriptor 
obtained from a creat, open , dup, fcntl, or pipe system call. 

The commands available are: 

FDUPFD Return a new file descriptor as follows: 

Lowest numbered available file descriptor greater than or 
equal to arg. 

Same open file (or pipe) as the original file. 

Same file pointer as the original file (i.e., both file descriptors 
share one file pointer). 

Same access mode (read, write or read/write). 

Same file status flags (i.e., both file descriptors share the 
same file status flags) . 

The close-on-exec flag associated with the new file descriptor 
is set to remain open across exec (2) system calls. 

FGETFD Get the close-on-exec flag associated with the file descriptor 

fildes. If the low-order bit is 0 the file will remain open 
across exec, otherwise the file will be closed upon execution 
of exec. 

F SETFD Set the close-on-exec flag associated with fildes to the low- 

order bit of arg (0 or 1 as above) . 

FGETFL Get file status flags. 

FSETFL Set file status flags to arg. Only certain flags can be set; see 

fcntl (.5). 

Fcntl will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[EMFILEl Cmd is F DUPFD and 20 file descriptors are currently open. 

[EM FILE] Cmd is F DUPFD and arg is negative or greater than 20. 

RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 

F DUPFD A new file descriptor. 

F GETFD Value of flag (only the low-order bit is defined). 

FJSETFD Value other than -1. 

F GETFL Value of file flags. 

F SETFL Value other than -1. 

Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

close(2), exec(2), open(2), fcntl(5). 
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NAME 

fork — create a new process 

SYNOPSIS 

int fork () 

DESCRIPTION 

Fork causes creation of a new process. The new process (child process) is an 
exact copy of the calling process (parent process). This means the child pro- 
cess inherits the following attributes from the parent process: 

environment 

close-on -exec flag (see exec (2)) 

signal handling settings (i.e., SIG_DFL, SIG_ING, function address) 

set-user-ID mode bit 

set-group-ID mode bit 

profiling on/off status 

nice value (see nice (2)) 

all attached shared memory segments (see shmop (2)) 
process group ID 

tty group ID (see exit{2) and signalil )) 

trace flag (see ptrace (2) request 0) 

time left until an alarm clock signal (see alarm (2)) 

current working directory 

root directory 

file mode creation mask (see umask( 2)) 
file size limit (see ulimit (2)) 

The child process differs from the parent process in the following ways: 

The child process has a unique process ID. 

The child process has a different parent process ID (i.e., the process ID 
of the parent process). 

The child process has its own copy of the parent’s file descriptors. 
Each of the child’s file descriptors shares a common file pointer with 
the corresponding file descriptor of the parent. 

All semadj values are cleared (see semop(2)). 

Process locks, text locks and data locks are not inherited by the child 
(see plock(2)). 

The child process’s utime, stime, cutime, and cstime are set to 0. The 
time left until an alarm clock signal is reset to 0. 

Fork will fail and no child process will be created if one or more of the follow- 
ing are true: 

[EAGAIN] The system-imposed limit on the total number of processes 
under execution would be exceeded. 

(EAGAIN] The system-imposed limit on the total number of processes 

under execution by a single user would be exceeded. 
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RETURN VALUE 

Upon successful completion, fork returns a value of 0 to the child process and 
returns the process ID of the child process to the parent process. Otherwise, a 
value of —1 is returned to the parent process, no child process is created, and 
errno is set to indicate the error. 

SEE ALSO 

exec (2), nice(2), plock(2), ptrace(2), semop(2), shmop(2), signal(2), times(2), 
ulimit(2), umask(2), wait(2). 
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NAME 

getpid, getpgrp, getppid — get process, process group, and parent process IDs 
SYNOPSIS 

int getpid 0 

int getpgrp 0 
int getppid 0 
DESCRIPTION 

Getpid returns the process ID of the calling process. 

Getpgrp returns the process group ID of the calling process. 

Getppid returns the parent process ID of the calling process. 

SEE ALSO 

exec (2), fork (2), intro (2), setpgrp(2), signal (2). 


- 1 - 



GETUID (2) 


GETUID (2) 


NAME 

getuid, geteuid, getgid, getegid - get real user, effective user, real group, and 
effective group IDs 
SYNOPSIS 

unsigned short getuid 0 
unsigned short geteuid 0 
unsigned short getgid 0 
unsigned short getegid () 

DESCRIPTION 

Getuid returns the real user ID of the calling process. 

Geteuid returns the effective user ID of the calling process. 

Getgid returns the real group ID of the calling process. 

Getegid returns the effective group ID of the calling process. 

SEE ALSO 

intro(2), setuid(2). 
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NAME 

ioctl — control device 
SYNOPSIS 

ioctl (tildes, request, arg) 
int Hides, request; 

DESCRIPTION 

Ioctl performs a variety of functions on character special files (devices). The 
write-ups of various devices in Section 7 of the UNIX System V Administrator 
Reference Manual discuss how ioctl applies to them. 

Ioctl will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[ENOTTY] Fildes is not associated with a character special device. 

[EINVAL] Request or arg is not valid. See Section 7 of the UNIX Sys- 
tem V Administrator Reference Manual. 

[EINTR] A signal was caught during the ioctl system call. 

RETURN VALUE 

If an error has occurred, a value of —1 is returned and errno is set to indicate 
the error. 

SEE ALSO 

termio(7) in the UNIX System V Administrator Reference Manual. 
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NAME 

kill — send a signal to a process or a group of processes 

SYNOPSIS 

int kill (pid, sig) 
int pid, sig; 

DESCRIPTION 

Kill sends a signal to a process or a group of processes. The process or group 
of processes to which the signal is to be sent is specified by pid. The signal 
that is to be sent is specified by sig and is either one from the list given in sig- 
nal (.2), or 0. If sig is 0 (the null signal), error checking is performed but no 
signal is actually sent. This can be used to check the validity of pid. 

The real or effective user ID of the sending process must match the real or 
effective user ID of the receiving process, unless the effective user ID of the 
sending process is super-user. 

The processes with a process ID of 0 and a process ID of 1 are special processes 
(see intro (.2)) and will be referred to below as procO and prod , respectively. 

If pid is greater than zero, sig will be sent to the process whose process ID is 
equal to pid. Pid may equal 1. 

If pid is 0, sig will be sent to all processes excluding procO and prod whose 
process group ID is equal to the process group ID of the sender. 

If pid is —1 and the effective user ID of the sender is not super-user, sig will be 
sent to all processes excluding procO and prod whose real user ID is equal to 
the effective user ID of the sender. 

If pid is -1 and the effective user ID of the sender is super-user, sig will be 
sent to all processes excluding procO and prod. 

If pid is negative but not — 1, sig will be sent to all processes whose process 
group ID is equal to the absolute value of pid. 

Kill will fail and no signal will be sent if one or more of the following are true: 
[EINVAL] Sig is not a valid signal number. 

[EINVAL] Sig is SIGKILL and pid is 1 (prod). 

[ESRCH] No process can be found corresponding to that specified by 

pid. 

[EPERM] The user ID of the sending process is not super-user, and its 

real or effective user ID does not match the real or effective 
user ID of the receiving process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

getpid(2), setpgrp(2), signal (2). 

kill(l) in the UNIX System V User Reference Manual. 
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NAME 

link — link to a file 
SYNOPSIS 

int link (pathl, path2) 
char *pathl, «path2; 

DESCRIPTION 

Pathl points to a path name naming an existing file. Path2 points to a path 
name naming the new directory entry to be created. Link creates a new link 
(directory entry) for the existing file. 

Link will fail and no link will be created if one or more of the following are 
true: 

[ENOTDIR] A component of either path prefix is not a directory. 

[ENOENT] A component of either path prefix does not exist. 

[EACCES] A component of either path prefix denies search permission. 

[ENOENT] The file named by pathl does not exist. 

[EEXIST] The link named by path2 exists. 

[EPERM] The file named by pathl is a directory and the effective user 

ID is not super-user. 

[EXDEV] The link named by path2 and the file named by pathl are on 

different logical devices (file systems). 

[ENOENT] Path2 points to a null path name. 

[EACCES] The requested link requires writing in a directory with a mode 
that denies write permission. 

[EROFS] The requested link requires writing in a directory on a read- 

only file system. 

[EFAULT] Path points outside the allocated address space of the process. 
[EMLINK] The maximum number of links to a file would be exceeded. 
RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

unlink(2). 
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NAME 

lseek — move read/write file pointer 
SYNOPSIS 

long lseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence; 

DESCRIPTION 

Fildes is a file descriptor returned from a creat, open , dup, or fcntl system call. 
Lseek sets the file pointer associated with fildes as follows: 

If whence is 0, the pointer is set to offset bytes. 

If whence is 1, the pointer is set to its current location plus offset. 

If whence is 2, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location, as measured in bytes 
from the beginning of the file, is returned. 

Lseek will fail and the file pointer will remain unchanged if one or more of the 
following are true: 

[EBADF] Fildes is not an open file descriptor. 

[ESPIPE] Fildes is associated with a pipe or fifo. 

[EINVAL and SIGSYS signal] 

Whence is not 0, 1, or 2. 

[EINVAL] The resulting file pointer would be negative. 

Some devices are incapable of seeking. The value of the file pointer associated 
with such a device is undefined. 

RETURN VALUE 

Upon successful completion, a non-negative integer indicating the file pointer 
value is returned. Otherwise, a value of —1 is returned and errno is set to indi- 
cate the error. 

SEE ALSO 

creat(2), dup(2), fcntl(2), open(2). 
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NAME 

maus — multiple-access-user-space (shared memory) operations 
SYNOPSIS 

#include <sys/fcntl.h> 

int getmaus (path, oflag) 
char *path; 
int oflag; 

int freemaus (mausdes) 
int mausdes; 

char *enabmaus (mausdes) 
int mausdes; 

int dismaus (saddr) 
char *saddr; 

char *switmaus (mausdes, saddr) 
int mausdes; 
char *saddr; 

DESCRIPTION 

MAUS (Multiple Access User Space) is a dedicated portion of physical memory 
that is subdivided into logical subsections. These subsections can be attached 
to the data segment of the calling process or released from its data segment 
with the following calls. 

Path points to a path name naming a special file that is one of the MAUS logi- 
cal subsections. Getmaus opens a maus descriptor for the named file and sets 
the file status flag according to the value of oflag. Oflag is one of the follow- 
ing: 

0_RDONLY Open for reading only. 

0_WRONLY Open for writing only. 

O RDWR Open for reading and writing. 

No process may have more than eight (8) maus descriptors open simultane- 
ously. 

The named file is opened unless one or more of the following are true: 
[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EINVAL] The named file is not a maus special file. 

[EACCES] A component of the path prefix denies search permission. 
[EACCES1 Oflag permission is denied for the named file. 

[EMFILE] Eight (8) maus descriptors are currently open. 

[ENXIO] The MAUS area associated with the special file does not exist. 

[EFAULT] Path points to an illegal address. 

Freemaus closes the maus descriptor specified by mausdes. Note that if a 
maus descriptor has been enabled (see enabmaus below) it may still be closed: 
a MAUS file remains attached to a data segment of the process until a dismaus 
(see below) is used to free it. 

[EBADF] Freemaus will fail if mausdes is not a valid open maus 

descriptor. 

Enabmaus attaches the MAUS file associated with mausdes to the data seg- 
ment of the calling process. The file is attached starting at the first available 
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8k-byte boundary address beyond the current break value (see brk (2)) . Note 
that multiple enabmaus calls can be made with the same maus descriptor. 
Each call will attach the file at a different 8k-byte boundary address. 

Enabmaus will fail and not attach the MAUS file if one or more of the follow- 
ing are true: 

[EBADF] Mausdes is not a valid open maus descriptor. 

[ENOMEM] No more 8k-byte boundary starting addresses are available. 

Dismaus frees from the calling process’s data segment the MAUS file that starts 
at the data segment address given by ( saddr — ( saddr modulus 8192)). 

[EINVAL] Dismaus will fail and not free the MAUS file if ( saddr — 

( saddr modulus 8192)) is not the data segment starting 
address of a MAUS file. 

Switmaus attaches the MAUS file associated with mausdes to the data segment 
of the calling process. The file is attached starting at the address given by 
( saddr — ( saddr modulus 8192)). 

Switmaus will fail if one or more of the following are true: 

[EBADF] Mausdes is not a valid open maus descriptor. 

[EINVAL] The value of ( saddr — ( saddr modulus 8192)) is not a legal 

8k-byte boundary address above the current break value. 

RETURN VALUES 

Upon successful completion, the return value is as follows: 

Getmaus returns a non-negative integer, namely a maus descriptor. 
Freemaus returns a value of 0. 

Enabmaus returns the data segment starting address of the attached 
MAUS file. 

Dismaus and switmaus return the maus descriptor previously associ- 
ated with the data segment starting address given by ( saddr — ( saddr 
modulus 8192)) if one exists. Otherwise, a value of —2 is returned. 

On other than successful completion, a value of —1 is returned with errno set to 
indicate the error. 
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NAME 

mknod — make a directory, or a special or ordinary file 
SYNOPSIS 

int mknod (path, mode, dev) 
char »path; 
int mode, dev; 

DESCRIPTION 

Mknod creates a new file named by the path name pointed to by path. The 
mode of the new file is initialized from mode, where the value of mode is 
interpreted as follows: 

0170000 file type; one of the following: 

0010000 fifo special 
0020000 character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 
0000777 access permissions; constructed from the following 
0000400 read by owner 
0000200 write by owner 

0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 

The owner ID of the file is set to the effective user ID of the process. The 
group ID of the file is set to the effective group ID of the process. 

Values of mode other than those above are undefined and should not be used. 
The low-order 9 bits of mode are modified by the process’s file mode creation 
mask: all bits set in the process’s file mode creation mask are cleared. See 
umask( 2). If mode indicates a block or character special file, dev is a 
configuration-dependent specification of a character or block I/O device. If 
mode does not indicate a block special or character special device, dev is 
ignored. 

Mknod may be invoked only by the super-user for file types other than FIFO 
special. 

Mknod will fail and the new file will not be created if one or more of the fol- 
lowing are true: 

[EPERM] The effective user ID of the process is not super-user. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] A component of the path prefix does not exist. 

[EROFS] The directory in which the file is to be created is located on a 

read-only file system. 

[EEXIST] The named file exists. 

[EFAULT] Path points outside the allocated address space of the process. 
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RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chmod(2), exec (2), umask(2), fs(4). 

mkdir(l) in the UNIX System V User Reference Manual. 
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NAME 

mount — mount a file system 
SYNOPSIS 

int mount (spec, dir, rwflag) 
char *spec, *dir; 
int rwflag; 

DESCRIPTION 

Mount requests that a removable file system contained on the block special file 
identified by spec be mounted on the directory identified by dir. Spec and dir 
are pointers to path names. 

Upon successful completion, references to the file dir will refer to the root 
directory on the mounted file system. 

The low-order bit of rwflag is used to control write permission on the mounted 
file system; if 1, writing is forbidden, otherwise writing is permitted according 
to individual file accessibility. 

Mount may be invoked only by the super-user. 

Mount will fail if one or more of the following are true: 

[EPERM] The effective user ID is not super-user. 

[ENOENTl Any of the named files does not exist. 

[ENOTDIR] A component of a path prefix is not a directory. 

[ENOTBLK] Spec is not a block special device. 

[ENXIO] The device associated with spec does not exist. 

[ENOTDIR] Dir is not a directory. 

[EFAULT] Spec or dir points outside the allocated address space of the 

process. 

[EBUSY] Dir is currently mounted on, is someone’s current working 

directory, or is otherwise busy. 

[EBUSY] The device associated with spec is currently mounted. 

[EBUSY] There are no more mount table entries. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

umount(2). 


- 1 - 



MSGCTL (2) 


MSGCTL(2) 


NAME 

msgctl — message control operations 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 
struct msqid_ds *buf; 


DESCRIPTION 

Msgctl provides a variety of message control operations as specified by cmd. 
The following cmd s are available: 


IPCJ3TAT 

Place the current value of each member of the data structure 
associated with msqid into the structure pointed to by buf. 
The contents of this structure are defined in intro (2). (READ) 

IPCSET 

Set the value of the following members of the data structure 
associated with msqid to the corresponding value found in the 
structure pointed to by buf. 
msg_perm.uid 
msg_perm.gid 

msgjDerm.mode /* only low 9 bits */ 
msg_qbytes 


This cmd can only be executed by a process that has an 
effective user ID equal to either that of super user or to the 
value of msg_perm.uid in the data structure associated with 
msqid. Only super user can raise the value of msg qbytes. 

IPCRMID 

Remove the message queue identifier specified by msqid from 
the system and destroy the message queue and data structure 
associated with it. This cmd can only be executed by a pro- 
cess that has an effective user ID equal to either that of super 
user or to the value of msg_perm.uid in the data structure 
associated with msqid. 

Msgctl will fail if one or more of the following are true: 

[EINVALl 

Msqid is not a valid message queue identifier. 

[EINVAL] 

Cmd is not a valid command. 

[EACCES] 

Cmd is equal to IPC_STAT and (READ) operation permission 
is denied to the calling process (see intro (. 2)). 

[EPERM] 

Cmd is equal to IPC_RMID or IPC_SET. The effective user ID 
of the calling process is not equal to that of super user and it 
is not equal to the value of msg_perm.uid in the data structure 
associated with msqid. 

[EPERMl 

Cmd is equal to IPC_SET, an attempt is being made to 
increase to the value of msg_qbytes, and the effective user ID 
of the calling process is not equal to that of super user. 

[EFAULT] 

Buf points to an illegal address. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of 1 
is returned and errno is set to indicate the error. 


SEE ALSO 

intro (2), msgget(2), msgop(2). 
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NAME 

msgget — get message queue 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/msg.h> 

int msgget (key, msgflg) 
keyt key; 
int msgflg; 

DESCRIPTION 

Msgget returns the message queue identifier associated with key. 

A message queue identifier and associated message queue and data structure 
(see intro ( 2)) are created for key if one of the following are true: 

10 Key is equal to IPC_PRIVATE. 

Key does not already have a message queue identifier associated with 
it, and ( msgflg & IPC_CREAT) is “true”. 

Upon creation, the data structure associated with the new message queue 
identifier is initialized as follows: 


Msg_perm.cuid, msg perrn.uid, msg_perm.cgid, and msg_perm.gid are 

set equal to the effective user ID and effective group ID, respectively, of 
the calling process. 

The low-order 9 bits of msg_perm.mode are set equal to the low-order 9 
bits of msgflg. 

Msg qnum, msg lspid, msg lrpid, msg stime, and msg rtime are set 
equal to 0. 


Msg_ctime is set equal to the current time. 


Msg_qbytes is set equal to the system limit. 
Msgget will fail if one or more of the following are true: 


[EACCES] 

tENOENT] 
[ENOS PC] 

[EEXIST] 


A message queue identifier exists for key, but operation per- 
mission (see intro (2)) as specified by the low-order 9 bits of 
msgflg would not be granted. 

A message queue identifier does not exist for key and ( msgflg 
& IPC_CREAT) is “false”. 

A message queue identifier is to be created but the system- 
imposed limit on the maximum number of allowed message 
queue identifiers system wide would be exceeded. 

A message queue identifier exists for key but ( ( msgflg & 
IPC CREAT) & ( msgflg & IPC_EXCL) ) is “true”. 


RETURN VALUE 

Upon successful completion, a non-negative integer, namely a message queue 
identifier, is returned. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 

intro (2), msgctl(2), msgop(2). 
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NAME 

msgop — message operations 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/msg.h> 

int msgsnd (msqid, msgp, msgsz, msgflg) 
int msqid; 

struct msgbuf *msgp; 
int msgsz, msgflg; 

int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msqid; 

struct msgbuf »msgp; 
int msgsz; 
long msgtyp; 
int msgflg; 

DESCRIPTION 

Msgsnd is used to send a message to the queue associated with the message 
queue identifier specified by msqid. (WRITE) Msgp points to a structure con- 
taining the message. This structure is composed of the following members: 

long mtype; /* message type */ 

char mtextU; /* message text */ 

Mtype is a positive integer that can be used by the receiving process for mes- 
sage selection (see msgrcv belowT Mtext is any text of length msgsz bytes. 
Msgsz can range from 0 to a system-imposed maximum. 

Msgflg specifies the action to be taken if one or more of the following are true: 

The number of bytes already on the queue is equal to msg qbytes (see 
intro ( 2)) . 

The total number of messages on all queues system-wide is equal to the 
system-imposed limit. 

These actions are as follows: 

If ( msgflg & IPC_NOWAIT) is “true”, the message will not be sent and 
the calling process will return immediately. 

If ( msgflg & IPC NOWAIT) is “false”, the calling process will suspend 
execution until one of the following occurs: 

The condition responsible for the suspension no longer exists, 
in which case the message is sent. 

Msqid is removed from the system (see msgctli 2)). When 
this occurs, errno is set equal to EIDRM, and a value of —1 is 
returned. 

The calling process receives a signal that is to be caught. In 
this case the message is not sent and the calling process 
resumes execution in the manner prescribed in signal ( 2)). 

Msgsnd will fail and no message will be sent if one or more of the following are 
true: 

[EINVAL] Msqid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process (see 

intro ( 2)). 
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[EINVAL] Mtype is less than 1. 

[EAGAIN] The message cannot be sent for one of the reasons cited above 

and ( msgflg & IPCNOWAIT) is “true”. 

[EINVAL] Msgsz is less than zero or greater than the system-imposed 

limit. 

[EFAULT] Msgp points to an illegal address. 

Upon successful completion, the following actions are taken with respect to the 
data structure associated with msqid (see intro (2)). 

Msg_qnum is incremented by 1 . 

Msg lspid is set equal to the process ID of the calling process. 
Msg_stime is set equal to the current time. 

Msgrcv reads a message from the queue associated with the message queue 
identifier specified by msqid and places it in the structure pointed to by msgp. 
(READ) This structure is composed of the following members: 

long mtype; /* message type */ 

char mtextN; /» message text */ 

Mtype is the received message’s type as specified by the sending process. 
Mtext is the text of the message. Msgsz specifies the size in bytes of mtext. 
The received message is truncated to msgsz bytes if it is larger than msgsz and 
(.msgflg & MSG NOERROR) is “true”. The truncated part of the message is 
lost and no indication of the truncation is given to the calling process. 

Msgtyp specifies the type of message requested as follows: 

If msgtyp is equal to 0, the first message on the queue is received. 

If msgtyp is greater than 0, the first message of type msgtyp is 
received. 

If msgtyp is less than 0, the first message of the lowest type that is less 
than or equal to the absolute value of msgtyp is received. 

Msgflg specifies the action to be taken if a message of the desired type is not 
on the queue. These are as follows: 

If (msgflg & IPC_NOWAIT) is “true”, the calling process will return 
immediately with a return value of —1 and errno set to ENOMSG. 

If (msgflg & IPC NOWAIT) is “false”, the calling process will suspend 
execution until one of the following occurs: 

A message of the desired type is placed on the queue. 

Msqid is removed from the system. When this occurs, errno 
is set equal to EIDRM, and a value of —1 is returned. 

The calling process receives a signal that is to be caught. In 
this case a message is not received and the calling process 
resumes execution in the manner prescribed in signal (2)). 

Msgrcv will fail and no message will be received if one or more of the following 
are true: 

[EINVAL] Msqid is not a valid message queue identifier. 

[EACCES1 Operation permission is denied to the calling process. 

[EINVAL] Msgsz is less than 0. 

[E2BIG] Mtext is greater than msgsz and (msgflg & MSG_NOERROR) 

is “false”. 
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[ENOMSG] The queue does not contain a message of the desired type and 
Imsgtyp & IPC_NOWAIT) is “true”. 

[EFAULT] Msgp points to an illegal address. 

Upon successful completion, the following actions are taken with respect to the 
data structure associated with msqid (see intro (2)). 

Msg qnum is decremented by 1 . 

Msg lrpid is set equal to the process ID of the calling process. 
Msg_rtime is set equal to the current time. 

RETURN VALUES 

If msgsnd or msgrcv return due to the receipt of a signal, a value of —1 is 
returned to the calling process and errno is set to EINTR. If they return due to 
removal of msqid from the system, a value of —1 is returned and errno is set to 
EIDRM. 

Upon successful completion, the return value is as follows: 

Msgsnd returns a value of 0. 

Msgrcv returns a value equal to the number of bytes actually placed 
into mtext. 

Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

intro (2), msgctl(2), msgget(2), signal (2). 
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NAME 

nice — change priority of a process 

SYNOPSIS 

int nice (incr) 
int incr; 

DESCRIPTION 

Nice adds the value of incr to the nice value of the calling process. A process’s 
nice value is a positive number for which a more positive value results in lower 
CPU priority. 

A maximum nice value of 39 and a minimum nice value of 0 are imposed by 
the system. Requests for values above or below these limits result in the nice 
value being set to the corresponding limit. 

[EPERM] Nice will fail and not change the nice value if incr is negative 

or greater than 40 and the effective user ID of the calling pro- 
cess is not super-user. 

RETURN VALUE 

Upon successful completion, nice returns the new nice value minus 20. Other- 
wise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2). 

nice(l) in the UNIX System V User Reference Manual. 


- 1 - 



OPEN (2) 


OPEN (2) 


NAME 

open — open for reading or writing 

SYNOPSIS 

#include <fcntl.h> 

int open (path, oflag [ , mode ] ) 

char *path; 

int oflag, mode; 

DESCRIPTION 

Path points to a path name naming a file. Open opens a file descriptor for the 
named file and sets the file status flags according to the value of oflag. Oflag 
values are constructed by or-ing flags from the following list (only one of the 
first three flags below may be used) : 

ORDONLY Open for reading only. 

OWRONLY Open for writing only. 

O RDWR Open for reading and writing. 

O NDELAY This flag may affect subsequent reads and writes. See read (2) 
and write (2). 

When opening a FIFO with O RDONLY or O WRONLY set: 

If O NDELAY is set: 

An open for reading-only will return without delay. 
An open for writing-only will return an error if no pro- 
cess currently has the file open for reading. 

If O N DELAY is clear: 

An open for reading-only will block until a process 
opens the file for writing. An open for writing-only 
will block until a process opens the file for reading. 

When opening a file associated with a communication line: 

If O NDELAY is set: 

The open will return without waiting for carrier. 

If O NDELAY is clear: 

The open will block until carrier is present. 

O APPEND If set, the file pointer will be set to the end of the file prior to 
each write. 

O CREAT If the file exists, this flag has no effect. Otherwise, the owner 
ID of the file is set to the effective user ID of the process, the 
group ID of the file is set to the effective group ID of the pro- 
cess, and the low-order 12 bits of the file mode are set to the 
value of mode modified as follows (see creal (2)): 

All bits set in the file mode creation mask of the pro- 
cess are cleared. See umask(2). 

The “save text image after execution bit” of the mode 
is cleared. See chmod (2) . 

O TRUNC If the file exists, its length is truncated to 0 and the mode and 
owner are unchanged. 

OEXCL If OEXCL and O CREAT are set, open will fail if the file 

exists. 
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The file pointer used to mark the current position within the file is set to the 
beginning of the file. 


The new file descriptor is set to remain open across exec system calls. See 
fcntl (2) . 

The named file is opened unless one or more of the following are true: 
[ENOTDIR] 

[ENOENT] 

[EACCES1 
[EACCES] 

[EISDIR] 

[EROFS] 


A component of the path prefix is not a directory. 

OCREAT is not set and the named file does not exist. 

A component of the path prefix denies search permission. 

Oflag permission is denied for the named file. 

The named file is a directory and oflag is write or read/write. 

The named file resides on a read-only file system and oflag is 
write or read/write. 


[EMFILE] 

[ENXIO] 

[ETXTBSYl 

[EFAULT] 

[EEXIST] 

[ENXIO] 

[EINTR] 
[ENFILE] 
RETURN VALUE 


Twenty (20) file descriptors are currently open. 

The named file is a character special or block special file, and 
the device associated with this special file does not exist. 

The file is a pure procedure (shared text) file that is being 
executed and oflag is write or read/write. 

Path points outside the allocated address space of the process. 

O CREAT and O EXCL are set, and the named file exists. 

O NDELAY is set, the named file is a FIFO, O WRONLY is 
set, and no process has the file open for reading. 

A signal was caught during the open system call. 

The system file table is full. 


Upon successful completion, the file descriptor is returned. Otherwise, a value 
of —1 is returned and errno is set to indicate the error. 


SEE ALSO 

chmod(2), close(2), creat(2), dup(2), fcntl(2), lseek(2), read(2), umask(2), 
write (2). 
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NAME 

pause — suspend process until signal 

SYNOPSIS 

pause 0 

DESCRIPTION 

Pause suspends the calling process until it receives a signal. The signal must 
be one that is not currently set to be ignored by the calling process. 

If the signal causes termination of the calling process, pause will not return. 

If the signal is caught by the calling process and control is returned from the 
signal-catching function (see signal (2)), the calling process resumes execution 
from the point of suspension; with a return value of —1 from pause and errno 
set to EINTR. 

SEE ALSO 

alarm(2), kill (2) , signal(2), wait(2). 
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NAME 

pipe — create an interprocess channel 

SYNOPSIS 

int pipe (Hides) 
int fildes!2l; 

DESCRIPTION 

Pipe creates an I/O mechanism called a pipe and returns two file descriptors, 
fildes[ 0] and fildes[\]. Fildes[ 0] is opened for reading and fildes[\] is opened 
for writing. 

Up to 5120 bytes of data are buffered by the pipe before the writing process is 
blocked. A read only file descriptor fildes[ 0] accesses the data written to 
fildes [1] on a first-in-first-out (FIFO) basis. 

[EMFILEl Pipe will fail if 19 or more file descriptors are currently open. 

[ENFILE] The system file table is full. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

read (2), write (2). 

sh(l) in the UNIX System V User Reference Manual. 
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NAME 

plock — lock process, text, or data in memory 
SYNOPSIS 

#include <sys/lock.h> 

int plock (op) 
int op; 

DESCRIPTION 

Plock allows the calling process to lock its text segment (text lock), its data 
segment (data lock), or both its text and data segments (process lock) into 
memory. Locked segments are immune to all routine swapping. Plock also 
allows these segments to be unlocked. The effective user ID of the calling pro- 
cess must be super-user to use this call. Op specifies the following: 

PROCLOCK - lock text and data segments into memory (process 
lock) 

TXTLOCK - lock text segment into memory (text lock) 

DATLOCK - lock data segment into memory (data lock) 

UNLOCK - remove locks 

Plock will fail and not perform the requested operation if one or more of the 
following are true: 


[EPERM] 

The effective user ID of the calling process is not super-user. 

[EINVAL] 

Op is equal to PROCLOCK and a process lock, a text lock, or a 
data lock already exists on the calling process. 

[E1NVAL] 

Op is equal to TXTLOCK and a text lock, or a process lock 
already exists on the calling process. 

[EINVAL] 

Op is equal to DATLOCK and a data lock, or a process lock 
already exists on the calling process. 

[EINVAL] 

Op is equal to UNLOCK and no type of lock exists on the cal- 
ling process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned to the calling process. 
Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2). 
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NAME 

profil — execution time profile 
SYNOPSIS 

void profil (buff, bufsiz, offset, scale) 
char »buff; 

int bufsiz, offset, scale; 

DESCRIPTION 

Buff points to an area of core whose length (in bytes) is given by bufsiz. After 
this call, the user’s program counter (pc) is examined each clock tick (60th 
second); offset is subtracted from it, and the result multiplied by scale. If the 
resulting number corresponds to a word inside buff, that word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction with binary point at 
the left: 0177777 (octal) gives a 1-1 mapping of pc’s to words in buff\ 077777 
(octal) maps each pair of instruction words together. 02(octal) maps all 
instructions onto the beginning of buff (producing a non-interrupting core 
clock) . 

Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by 
giving a bufsiz of 0. Profiling is turned off when an exec is executed, but 
remains on in child and parent both after a fork. Profiling will be turned off if 
an update in buff would cause a memory fault. 

RETURN VALUE 
Not defined. 

SEE ALSO 

monitor(3C). 

prof(l) in the UNIX System V User Reference Manual. 
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NAME 

ptrace — process trace 
SYNOPSIS 

int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 

DESCRIPTION 

Ptrace provides a means by which a parent process may control the execution 
of a child process. Its primary use is for the implementation of breakpoint 
debugging; see sdb( 1). The child process behaves normally until it encounters 
a signal (see signal (2) for the list), at which time it enters a stopped state and 
its parent is notified via wait (2). When the child is in the stopped state, its 
parent can examine and modify its “core image” using ptrace. Also, the parent 
can cause the child either to terminate or continue, with the possibility of 
ignoring the signal that caused it to stop. 

The request argument determines the precise action to be taken by ptrace and 
is one of the following: 

0 This request must be issued by the child process if it is to be 
traced by its parent. It turns on the child’s trace flag that stipu- 
lates that the child should be left in a stopped state upon receipt 
of a signal rather than the state specified by funr, see signal (2). 
The pid, addr, and data arguments are ignored, and a return 
value is not defined for this request. Peculiar results will ensue if 
the parent does not expect to trace the child. 

The remainder of the requests can only be used by the parent process. For 
each, pid is the process ID of the child. The child must be in a stopped state 
before these requests are made. 

1, 2 With these requests, the word at location addr in the address 
space of the child is returned to the parent process. If I and D 
space are separated (as on PDP-lls), request 1 returns a word 
from I space, and request 2 returns a word from D space. If I 
and D space are not separated (as on the 3B 20 computer and 
VAX-11/780), either request 1 or request 2 may be used with 
equal results. The data argument is ignored. These two requests 
will fail if addr is not the start address of a word, in which case a 
value of —1 is returned to the parent process and the parent’s 
errno is set to EIO. 

3 With this request, the word at location addr in the child’s USER 
area in the system’s address space (see <sys/user.h>) is 
returned to the parent process. Addresses in this area range from 
0 to 1024 on the PDP-lls and 0 to 2048 on the 3B 20 computer 
and VAX. The data argument is ignored. This request will fail 
if addr is not the start address of a word or is outside the USER 
area, in which case a value of —1 is returned to the parent pro- 
cess and the parent’s errno is set to EIO. 

4, 5 With these requests, the value given by the data argument is 
written into the address space of the child at location addr . If I 
and D space are separated (as on PDP-lls), request 4 writes a 
word into I space, and request 5 writes a word into D space. If I 
and D space are not separated (as on the 3B 20 computer and 
VAX), either request 4 or request 5 may be used with equal 
results. Upon successful completion, the value written into the 
address space of the child is returned to the parent. These two 
requests will fail if addr is a location in a pure procedure space 
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and another process is executing in that space, or addr is not the 
start address of a word. Upon failure a value of —1 is returned 
to the parent process and the parent’s errno is set to EIO. 

6 With this request, a few entries in the child’s USER area can be 
written. Data gives the value that is to be written and addr is 
the location of the entry. The few entries that can be written 
are: 

the general registers (i.e., registers 0—11 on the 3B 20 
computer, registers 0-7 on PDP-lls, and registers 0-15 
on the VAX) 

the condition codes of the Processor Status Word on the 
3B 20 computer 

the floating point status register and six floating point 
registers on PDP-1 Is 

certain bits of the Processor Status Word on PDP-lls 
(i.e, bits 0—4 and 8—11) 

certain bits of the Processor Status Longword on the 
VAX (i.e., bits 0-7, 16-20, and 30-31). 

7 This request causes the child to resume execution. If the data 
argument is 0, all pending signals including the one that caused 
the child to stop are canceled before it resumes execution. If the 
data argument is a valid signal number, the child resumes execu- 
tion as if it had incurred that signal, and any other pending sig- 
nals are canceled. The addr argument must be equal to 1 for 
this request. Upon successful completion, the value of data is 
returned to the parent. This request will fail if data is not 0 or a 
valid signal number, in which case a value of —1 is returned to 
the parent process and the parent’s errno is set to EIO. 

8 This request causes the child to terminate with the same conse- 
quences as exit (2). 

9 This request sets the trace bit in the Processor Status Word of 
the child (i.e., bit 4 on PDP-lls; bit 30 on the VAX) and then 
executes the same steps as listed above for request 7. The trace 
bit causes an interrupt upon completion of one machine instruc- 
tion. This effectively allows single stepping of the child. On the 
3B 20 computer, there is no trace bit; and this request returns an 
error. 

Note: The trace bit remains set after an interrupt on PDP-lls but 
is turned off after an interrupt on the VAX. 

To forestall possible fraud, ptrace inhibits the set-user-id facility on subsequent 

exec (.2) calls. If a traced process calls exec , it will stop before executing the 

first instruction of the new image showing signal SIGTRAP. 

GENERAL ERRORS 

Ptrace will in general fail if one or more of the following are true: 

[EIO] Request is an illegal number. 

[ESRCHl Pid identifies a child that does not exist or has not executed a 

ptrace with request 0. 

SEE ALSO 

exec(2), signal(2), wait(2). 

sdb(l) in the UNIX System V User Reference Manual. 
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NAME 

read — read from file 
SYNOPSIS 

int read (fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat , open , dup,fcntl , or pipe sys- 
tem call. 

Read attempts to read nbyte bytes from the file associated with fildes into the 
buffer pointed to by buf. 

On devices capable of seeking, the read starts at a position in the file given by 
the file pointer associated with fildes. Upon return from read , the file pointer 
is incremented by the number of bytes actually read. 

Devices that are incapable of seeking always read from the current position. 
The value of a file pointer associated with such a file is undefined. 

Upon successful completion, read returns the number of bytes actually read 
and placed in the buffer; this number may be less than nbyte if the file is asso- 
ciated with a communication line (see ioctll 2) and termioi 7)), or if the 
number of bytes left in the file is less than nbyte bytes. A value of 0 is 
returned when an end-of-file has been reached. 

When attempting to read from an empty pipe (or FIFO): 

If ONDELAY is set, the read will return a 0. 

If ON DELAY is clear, the read will block until data is written to the 
file or the file is no longer open for writing. 

When attempting to read a file associated with a tty that has no data currently 
available: 

If O NDELAY is set, the read will return a 0. 

If O NDELAY is clear, the read will block until data becomes avail- 
able. 

Read will fail if one or more of the following are true: 

[EBADFl Fildes is not a valid file descriptor open for reading. 

[EFAULT] Buf points outside the allocated address space. 

[EINTR] A signal was caught during the read system call. 

RETURN VALUE 

Upon successful completion a non-negative integer is returned indicating the 
number of bytes actually read. Otherwise, a —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

creat (2), dup(2), fcntl(2), ioctl (2) , open (2), pipe (2). 

termio(7) in the UNIX System V Administrator Reference Manual. 
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NAME 

semctl — semaphore control operations 
SYNOPSIS 

#include <sys/types.h> 

#inelude <sys/ipc.h> 

#include <sys/sem.h> 

int semctl (semid, semnum, cmd, arg) 
int semid, cmd; 
int semnum; 
union semun { 
int val; 

struct semid_ds *buf; 
ushort ‘array; 

} arg; 

DESCRIPTION 

Semctl provides a variety of semaphore control operations as specified by cmd. 

The following cmds are executed with respect to the semaphore specified by 
semid and semnum: 

GETVAL Return the value of semval (see intro (2)). {READ) 

SETVAL Set the value of semval to arg.val. (ALTER) When this 

cmd is successfully executed, the semadj value 
corresponding to the specified semaphore in all processes 
is cleared. 

GETPID Return the value of sempid. (READ) 

GETNCNT Return the value of semncnt. (READ) 

GETZCNT Return the value of semzcnt. (READ) 

The following cmd s return and set, respectively, every semval in the set of 
semaphores. 

GETALL Place semvals into array pointed to by arg. array. 

(READ) 

SETALL Set semvals according to the array pointed to by 

arg. array. (ALTER) When this cmd is successfully exe- 
cuted the semadj values corresponding to each specified 
semaphore in all processes are cleared. 

The following cmd s are also available: 

IPC_STAT Place the current value of each member of the data 
structure associated with semid into the structure pointed 
to by arg.buf. The contents of this structure are defined 
in intro (2). (READ) 

IPC SET Set the value of the following members of the data struc- 
ture associated with semid to the corresponding value 
found in the structure pointed to by arg.buf'. 

sem_perm.uid 

sem_perm.gid 

sem jerm.mode /• only low 9 bits •/ 

This cmd can only be executed by a process that has an 
effective user ID equal to either that of super-user or to 
the value of sem_perm.uid in the data structure associ- 
ated with semid. 
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IPC_RMID Remove the semaphore identifier specified by semid from 
the system and destroy the set of semaphores and data 
structure associated with it. This cmd can only be exe- 
cuted by a process that has an effective user ID equal to 
either that of super-user or to the value of semperm.uid 
in the data structure associated with semid. 


Semctl will fail if one or more of the following are true: 

[EINVALl 

Semid is not a valid semaphore identifier. 

[EINVALl 

Semnum is less than zero or greater than sem nsems. 

[EINVALl 

Cmd is not a valid command. 

[EACCES1 

Operation permission is denied to the calling process 
(see intro (2)). 

[ERANGEl 

Cmd is SETVAL or SETALL and the value to which 
semval is to be set is greater than the system imposed 
maximum. 

[EPERMl 

Cmd is equal to IPC RMID or IPC SET and the 
effective user ID of the calling process is not equal to 
that of super-user and it is not equal to the value of 
sem_perm.uid in the data structure associated with 
semid. 

[EFAULT] 

RETURN VALUE 

Arg.buf points to an illegal address. 

Upon successful com 

pletion, the value returned depends on cmd as follows: 

GETVAL 

The value of semval. 

GETPID 

The value of sempid. 

GETNCNT 

The value of semncnt. 

GETZCNT 

The value of semzcnt. 

All others 

A value of 0. 


Otherwise, a value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 

intro(2), semget(2), semop(2). 
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NAME 

semget — get set of semaphores 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/sem.h> 

int semget (key, nsems, semflg) 

keyt key; 

int nsems, semflg; 

DESCRIPTION 

Semget returns the semaphore identifier associated with key. 

A semaphore identifier and associated data structure and set containing nsems 
semaphores (see intro(2 )) are created for key if one of the following are true: 

Key is equal to IPC PRIVATE. 

Key does not already have a semaphore identifier associated with it, 
and ( semflg & IPC_CREAT) is “true”. 

Upon creation, the data structure associated with the new semaphore identifier 
is initialized as follows: 

Sem jerm.cuid, sem_perm.uid, semjperm.cgid, and semjierm.gid are set 

equal to the effective user ID and effective group ID, respectively, of 
the calling process. 

The low-order 9 bits of sem_perm.mode are set equal to the low-order 9 
bits of semflg. 

Sem_nsems is set equal to the value of nsems. 

Sem_otime is set equal to 0 and sem_ctime is set equal to the current 
time. 


Semget will fail if one or more of the following are true: 


[EINVAL] 

[EACCESl 

[EINVAL] 

[ENOENT] 

[ENOSPC] 

[ENOSPC] 

[EEXISTl 


Nsems is either less than or equal to zero or greater than the 
system-imposed limit. 

A semaphore identifier exists for key, but operation permis- 
sion (see intro (2)) as specified by the low -order 9 bits of 
semflg would not be granted. 

A semaphore identifier exists for key, but the number of 
semaphores in the set associated with it is less than nsems and 
nsems is not equal to zero. 

A semaphore identifier does not exist for key and ( semflg & 
IPC CREAT) is “false”. 

A semaphore identifier is to be created but the system- 
imposed limit on the maximum number of allowed semaphore 
identifiers system wide would be exceeded. 

A semaphore identifier is to be created but the system- 
imposed limit on the maximum number of allowed semaphores 
system wide would be exceeded. 

A semaphore identifier exists for key but ( ( semflg & 
IPC_CREAT) and ( semflg & IPC_EXCL) ) is “true”. 
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RETURN VALUE 

Upon successful completion, a non-negative integer, namely a semaphore 
identifier, is returned. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

intro (2), semctl(2), semop(2). 
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NAME 

semop — semaphore operations 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/sem.h> 

int semop (semid, sops, nsops) 
int semid; 

struct sembuf **sops; 
int nsops; 

DESCRIPTION 

Semop is used to automatically perform an array of semaphore operations on 
the set of semaphores associated with the semaphore identifier specified by 
semid. Sops is a pointer to the array of semaphore-operation structures. 
Nsops is the number of such structures in the array. The contents of each 
structure includes the following members: 

short semnum; /* semaphore number */ 

short sem op; /* semaphore operation */ 

short sem flg; /» operation flags */ 

Each semaphore operation specified by sem op is performed on the correspond- 
ing semaphore specified by semid and semjxum. 

Sem_op specifies one of three semaphore operations as follows: 

If sem_op is a negative integer, one of the following will occur: 
(ALTER) 

If semval (see intro( 2)) is greater than or equal to the abso- 
lute value of sem op , the absolute value of sem op is sub- 
tracted from semval. Also, if ( sem Jig & SEM UNDO) is 
“true”, the absolute value of sem_op is added to the calling 
process’s semadj value (see exit (2)) for the specified sema- 
phore. 

If semval is less than the absolute value of sem op and 
(semjg & IPC_NOWAIT) is “true”, semop will return 
immediately. 

If semval is less than the absolute value of sem op and 
(.sem Jg & IPC NOWAIT) is “false”, semop will increment 
the semncnt associated with the specified semaphore and 
suspend execution of the calling process until one of the fol- 
lowing conditions occur. 

Semval becomes greater than or equal to the absolute value 
of sem op. When this occurs, the value of semncnt associ- 
ated with the specified semaphore is decremented, the abso- 
lute value of sem op is subtracted from semval and, if 
(sem Jg & SEM_UNDO) is “true”, the absolute value of 
sem_op is added to the calling process’s semadj value for the 
specified semaphore. 

The semid for which the calling process is awaiting action is 
removed from the system (see semctl( 2)). When this occurs, 
errno is set equal to EIDRM, and a value of —1 is returned. 
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The calling process receives a signal that is to be caught. 
When this occurs, the value of semncnt associated with the 
specified semaphore is decremented, and the calling process 
resumes execution in the manner prescribed in signal (2) . 

If sem_op is a positive integer, the value of semop is added to semval 
and, if ( sem Jig & SEM_UNDO) is “true”, the value of sem op is sub- 
tracted from the calling process’s semadj value for the specified sema- 
phore. (ALTER) 

If sem op is zero, one of the following will occur: (READ) 

If semval is zero, semop will return immediately. 

If semval is not equal to zero and ( sem Jig & IPCNOWAIT) 
is “true”, semop will return immediately. 

If semval is not equal to zero and (sem Jig 8c IPC_NOWAIT) 
is “false”, semop will increment the semzcnt associated with 
the specified semaphore and suspend execution of the calling 
process until one of the following occurs: 

Semval becomes zero, at which time the value of semzcnt 
associated with the specified semaphore is decremented. 

The semid for which the calling process is awaiting action is 
removed from the system. When this occurs, errno is set 
equal to EIDRM, and a value of —1 is returned. 

The calling process receives a signal that is to be caught. 
When this occurs, the value of semzcnt associated with the 
specified semaphore is decremented, and the calling process 
resumes execution in the manner prescribed in signal (2). 


Semop will fail if one or more of the following are true for any of the sema- 
phore operations specified by sops : 


[EINVALl 

[EFBIG] 

(E2BIG1 

[EACCES] 


Semid is not a valid semaphore identifier. 

Sem num is less than zero or greater than or equal to the 
number of semaphores in the set associated with semid. 

Nsops is greater than the system-imposed maximum. 

Operation permission is denied to the calling process (see 
intro (2)). 


[EAGAIN] 
[ENOS PC] 
[EINVAL] 
[ERANGE] 
[ERANGE] 


The operation would result in suspension of the calling process 
but (sem Jig & IPC_NOWAIT) is “true”. 

The limit on the number of individual processes requesting an 
SEMUNDO would be exceeded. 

The number of individual semaphores for which the calling 
process requests a SEM UNDO would exceed the limit. 

An operation would cause a semval to overflow the system- 
imposed limit. 

An operation would cause a semadj value to overflow the 
system-imposed limit. 


[EFAULT] Sops points to an illegal address. 

Upon successful completion, the value of sempid for each semaphore specified 
in the array pointed to by sops is set equal to the process ID of the calling pro- 
cess. 
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RETURN VALUE 

U semop returns due to the receipt of a signal, a value of -1 is returned to the 
calling process and errno is set to EINTR. If it returns due to the removal of a 
semid from the system, a value of —1 is returned and errno is set to EIDRM. 

Upon successful completion, the value of semval at the time of the call for the 
last operation in the array pointed to by sops is returned. Otherwise, a value of 
-1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec (2), exit(2), fork(2), intro(2), semctl(2), semget(2). 
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NAME 

setpgrp — set process group ID 

SYNOPSIS 

int setpgrp 0 

DESCRIPTION 

Setpgrp sets the process group ID of the calling process to the process ID of the 
calling process and returns the new process group ID. 

RETURN VALUE 

Setpgrp returns the value of the new process group ID. 

SEE ALSO 

exec (2), fork(2), getpid(2), intro(2), kill (2), signal(2). 
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NAME 

setuid, setgid — set user and group IDs 

SYNOPSIS 

int setuid (uid) 
int uid; 

int setgid (gid) 
int gid; 

DESCRIPTION 

Setuid ( setgid ) is used to set the real user (group) ID and effective user 
(group) ID of the calling process. 

If the effective user ID of the calling process is super-user, the real user (group) 
ID and effective user (group) ID are set to uid (gid). 

If the effective user ID of the calling process is not super-user, but its real user 
(group) ID is equal to uid (gid), the effective user (group) ID is set to uid 
(gid). 

If the effective user ID of the calling process is not super-user, but the saved 
set-user (group) ID from exec( 2) is equal to uid (gid), the effective user 
(group) ID is set to uid (gid). 

Setuid (setgid) will fail if the real user (group) ID of the calling process is not 
equal to uid (gid) and its effective user ID is not super-user. [EPERM] 

The uid is out of range. [EINVAL] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

getuid(2), intro(2). 
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NAME 

shmctl — shared memory control operations 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/shm.h> 

int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid_ds *buf; 

DESCRIPTION 

Shmctl provides a variety of shared memory control operations as specified by 
cmd. The following cmds are available: 

IPC STAT Place the current value of each member of the data 
structure associated with shmid into the structure 
pointed to by buf. The contents of this structure are 
defined in intro (.2). (READ) 

IPCSET Set the value of the following members of the data struc- 
ture associated with shmid to the corresponding value 
found in the structure pointed to by buf : 
shm_perm.uid 
shmjperm.gid 

shm_perm.mode /* only low 9 bits »/ 

This cmd can only be executed by a process that has an 
effective user ID equal to either that of super-user or to 
the value of shmjierm.uid in the data structure associ- 
ated with shmid. 

IPC RMID Remove the shared memory identifier specified by shmid 
from the system and destroy the shared memory segment 
and data structure associated with it. This cmd can only 
be executed by a process that has an effective user ID 
equal to either that of super-user or to the value of 
shmjierm.uid in the data structure associated with 
shmid. 

Shmctl will fail if one or more of the following are true: 

[EINVALl Shmid is not a valid shared memory identifier. 

[EINVAL] Cmd is not a valid command. 

[EACCES] Cmd is equal to IPC_STAT and (READ) operation 

permission is denied to the calling process (see 
intro ( 2 )) . 

[EPERM] Cmd is equal to IPC_RMID or IPC_SET and the 

effective user ID of the calling process is not equal to 
that of super-user and it is not equal to the value of 
shmjierm.uid in the data structure associated with 
shmid. 

[EFAULT] Buf points to an illegal address. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

intro (2), shmget(2), shmop(2). 
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NAME 

shmget — get shared memory segment 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/shm.h> 

int shmget (key, size, shmflg) 

key_t key; 

int size, shmflg; 

DESCRIPTION 

Shmget returns the shared memory identifier associated with key. 

A shared memory identifier and associated data structure and shared memory 
segment of size size bytes (see intro (2)) are created for key if one of the fol- 
lowing are true: 

Key is equal to IPC PRIVATE. 

Key does not already have a shared memory identifier associated with 
it, and ( shmflg & IPC_CREAT) is “true”. 

Upon creation, the data structure associated with the new shared memory 
identifier is initialized as follows: 


Shm_perm.cuid, shm_perm.uid, shmjperm.cgid, and shm_perm.gid are 

set equal to the effective user ID and effective group ID, respectively, of 
the calling process. 


The low-order 9 bits of shm_perm.mode are set equal to the low-order 9 
bits of shmflg. Shm_segsz is set equal to the value of size. 

Shm lpid, shmnattch, shm atime, and shm dtime are set equal to 0. 
Shm ctime is set equal to the current time. 


Shmget will fail if one or more of the following are true: 


[EINVAL] 

[EACCES] 

[EINVAL] 


[ENOENT] 


Size is less than the system-imposed minimum or greater than 
the system-imposed maximum. 

A shared memory identifier exists for key but operation per- 
mission (see intro (2)) as specified by the low-order 9 bits of 
shmflg would not be granted. 

A shared memory identifier exists for key but the size of the 
segment associated with it is less than size and size is not 
equal to zero. 

A shared memory identifier does not exist for key and (.shmflg 
& IPC CREAT) is “false”. 


[ENOS PC] 

[ENOMEM] 


[EEXIST] 


A shared memory identifier is to be created but the system- 
imposed limit on the maximum number of allowed shared 
memory identifiers system wide would be exceeded. 

A shared memory identifier and associated shared memory 
segment are to be created but the amount of available physi- 
cal memory is not sufficient to fill the request. 

A shared memory identifier exists for key but ( ( shmflg & 
IPC_CREAT) and ( shmflg & IPC_EXCL) ) is “true”. 
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RETURN VALUE 

Upon successful completion, a non-negative integer, namely a shared memory 
identifier is returned. Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

intro(2), shmctl(2), shmop(2). 
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NAME 

shmop — shared memory operations 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/shm.h> 

char ’shmat (shmid, shmaddr, shmflg) 
int shmid; 
char ’shmaddr 
int shmflg; 

int shmdt (shmaddr) 
char ’shmaddr 

DESCRIPTION 

Shmat attaches the shared memory segment associated with the shared 
memory identifier specified by shmid to the data segment of the calling process. 
The segment is attached at the address specified by one of the following cri- 
teria: 


If shmaddr is equal to zero, the segment is attached at the first avail- 
able address as selected by the system. 

If shmaddr is not equal to zero and ( shmflg & SHMRND) is “true”, 
the segment is attached at the address given by ( shmaddr - ( shmaddr 
modulus SHMLBA)). 


If shmaddr is not equal to zero and ( shmflg & SHM RND) is “false”, 
the segment is attached at the address given by shmaddr. 

The segment is attached for reading if ( shmflg & SHM RDONLY) is “true” 
(READ), otherwise it is attached for reading and writing {READ/WRITE). 

Shmat will fail and not attach the shared memory segment if one or more of 
the following are true: 


[EINVAL] 

[EACCES] 

[ENOMEM] 

[EINVAL] 

[EINVAL] 

[EMFILE] 

[EINVAL] 


Shmid is not a valid shared memory identifier. 

Operation permission is denied to the calling process (see 
intro (2)). 

The available data space is not large enough to accommodate 
the shared memory segment. 

Shmaddr is not equal to zero, and the value of ( shmaddr - 
( shmaddr modulus SHMLBA)) is an illegal address. 

Shmaddr is not equal to zero, ( shmflg & SHM RND) is 
“false”, and the value of shmaddr is an illegal address. 

The number of shared memory segments attached to the cal- 
ling process would exceed the system-imposed limit. 

Shmdt detaches from the calling process’s data segment the 
shared memory segment located at the address specified by 
shmaddr. 


[EINVAL] Shmdt will fail and not detach the shared memory segment if 

shmaddr is not the data segment start address of a shared 
memory segment. 


- 1 - 



SHMOP(2) 


SHMOP(2) 


RETURN VALUES 

Upon successful completion, the return value is as follows: 

Shmat returns the data segment start address of the attached shared 
memory segment. 

Shmdt returns a value of 0. 

Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), intro(2), shmctl(2), shmget(2). 
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NAME 

signal - specify what to do upon receipt of a signal 
SYNOPSIS 

#include <signal.h> 

int ('signal (sig, func))() 
int sig; 

void ('func)O; 

DESCRIPTION 

Signal allows the calling process to choose one of three ways in which it is pos- 
sible to handle the receipt of a specific signal. Sig specifies the signal and func 
specifies the choice. 

Sig can be assigned any one of the following except SIGKILL: 


SIGHUP 

01 

hangup 

SIGINT 

02 

interrupt 

SIGQUIT 

03* 

quit 

SIGILL 

04* 

illegal instruction (not reset when caught) 

SIGTRAP 

05* 

trace trap (not reset when caught) 

SIGIOT 

06* 

IOT instruction 

SIGEMT 

07* 

EMT instruction 

SIGFPE 

08* 

floating point exception 

SIGKILL 

09 

kill (cannot be caught or ignored) 

SIGBUS 

10* 

bus error 

SIGSEGV 

11* 

segmentation violation 

SIGSYS 

12* 

bad argument to system call 

SIGPIPE 

13 

write on a pipe with no one to read it 

SIGALRM 

14 

alarm clock 

SIGTERM 

15 

software termination signal 

SIGUSR1 

16 

user-defined signal 1 

SIGUSR2 

17 

user-defined signal 2 

SIGCLD 

18 

death of a child 
(see WARNING below) 

SIGPWR 

19 

power fail 

(see WARNING below) 


See below for the significance of the asterisk (*) in the above list. 

Func is assigned one of three values: SIGDFL, SIG IGN, or a function address. 

The actions prescribed by these values are as follows: 

SIG DFL — terminate process upon receipt of a signal 

Upon receipt of the signal sig , the receiving process is to be ter- 
minated with all of the consequences outlined in exit {2). In addi- 
tion a “core image” will be made in the current working directory 
of the receiving process if sig is one for which an asterisk appears in 
the above list and the following conditions are met: 

The effective user ID and the real user ID of the receiving 
process are equal. 

An ordinary file named core exists and is writable or can 
be created. If the file must be created, it will have the fol- 
lowing properties: 

a mode of 0666 modified by the file creation 
mask (see umaski 2)) 

a file owner ID that is the same as the effective 
user ID of the receiving process. 
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a file group ID that is the same as the effective 
group ID of the receiving process 

SIG IGN — ignore signal 

The signal sig is to be ignored. 

Note: the signal SIGKILL cannot be ignored. 

function address — catch signal 

Upon receipt of the signal sig , the receiving process is to execute the 
signal-catching function pointed to by func. The signal number sig 
will be passed as the only argument to the signal-catching function. 
Additional arguments are passed to the signal-catching function for 
hardware-generated signals. Before entering the signal-catching func- 
tion, the value of func for the caught signal will be set to SIG_DFL 
unless the signal is SIGILL, SIGTRAP, or SIGPWR. 

Upon return from the signal-catching function, the receiving process 
will resume execution at the point it was interrupted. 

When a signal that is to be caught occurs during a read, a write, an 
open , or an ioctl system call on a slow device (like a terminal; but not 
a file), during a pause system call, or during a wait system call that 
does not return immediately due to the existence of a previously 
stopped or zombie process, the signal catching function will be exe- 
cuted and then the interrupted system call may return a -1 to the 
calling process with errno set to EINTR. 

Note: The signal SIGKILL cannot be caught. 

A call to signal cancels a pending signal sig except for a pending SIGKILL sig- 
nal. 

Signal will fail if sig is an illegal signal number, including SIGKILL. [EINVALl 
RETURN VALUE 

Upon successful completion, signal returns the previous value of func for the 
specified signal sig. Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

kill(2), pause(2), ptrace(2), wait(2), setjmp(3C). 
kill(l) in the UNIX System V User Reference Manual. 

WARNING 

Two other signals that behave differently than the signals described above exist 
in this release of the system; they are: 

SIGCLD 18 death of a child (reset when caught) 

SIGPWR 19 power fail (not reset when caught) 

There is no guarantee that, in future releases of the UNIX system, these signals 
will continue to behave as described below; they are included only for compati- 
bility with other versions of the UNIX system. Their use in new programs is 
strongly discouraged. 

For these signals, func is assigned one of three values: SIGDFL, SIG IGN, or a 
function address. The actions prescribed by these values of are as follows: 

SIG_DFL - ignore signal 

The signal is to be ignored. 

SIG_IGN - ignore signal 

The signal is to be ignored. Also, if sig is SIGCLD, the calling 
process’s child processes will not create zombie processes when they 
terminate; see exit (2) . 
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function address - catch signal 

If the signal is SIGPWR, the action to be taken is the same as that 
described above for func equal to function address. The same is 
true if the signal is SIGCLD except, that while the process is execut- 
ing the signal-catching function, any received SIGCLD signals will 
be queued and the signal-catching function will be continually reen- 
tered until the queue is empty. 

The SIGCLD affects two other system calls (wait (2), and exit (2)) in the fol- 
lowing ways: 

wait If the func value of SIGCLD is set to SIG IGN and a wait is exe- 
cuted, the wait will block until all of the calling process’s child 
processes terminate; it will then return a value of -1 with errno set 
to ECHILD. 

exit If in the exiting process’s parent process the func value of SIGCLD is 
set to SIG IGN, the exiting process will not create a zombie process. 

When processing a pipeline, the shell makes the last process in the pipeline 
the parent of the proceeding processes. A process that may be piped into in 
this manner (and thus become the parent of other processes) should take 
care not to set SIGCLD to be caught. 
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NAME 

stat, fstat - get file status 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/stat.h> 

int stat (path, buf) 
char *path; 
struct stat *buf; 

int fstat (tildes, buf) 
int tildes; 
struct stat »buf; 

DESCRIPTION 

Path points to a path name naming a file. Read, write, or execute permission 
of the named file is not required, but all directories listed in the path name 
leading to the file must be searchable. Stat obtains information about the 
named file. 

Similarly, fstat obtains information about an open file known by the file 
descriptor fildes, obtained from a successful open, creat, dup, fcntl, or pipe 
system call. 

Buf is a pointer to a stat structure into which information is placed concerning 
the file. 

The contents of the structure pointed to by buf include the following members: 


ushort 

st mode; 

/* File mode; see mknod (,2) */ 

ino_t 

st_ino; 

/* Inode number */ 

devt 

st_dev; 

/» ID of device containing */ 

/» a directory entry for this file »/ 

dev_t 

stjrdev; 

/* ID of device */ 



/» This entry is defined only for »/ 

/* character special or block special files */ 

short 

st_nlink; 

/* Number of links «/ 

ushort 

stuid; 

/* User ID of the file’s owner »/ 

ushort 

stjgid; 

/» Group ID of the file’s group «/ 

offj 

stsize; 

/* File size in bytes */ 

timet 

statime; 

/» Time of last access */ 

timet 

st_mtime; 

/• Time of last data modification */ 

timet 

st_ctime; 

/• Time of last file status change »/ 



/* Times measured in seconds since «/ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 


st_atime Time when file data was last accessed. Changed by the following 
system calls: creat (2), mknod (2), pipe (2), utime(2), and read (2). 

st mtime Time when data was last modified. Changed by the following sys- 
tem calls: creat (2), mknod (. 2), pipe (2), utimei 2), and write ( 2). 

st_ctime Time when file status was last changed. Changed by the following 
system calls: chmodl 2), chown(2) , creat (2), link (2), mknod (2) , 
pipe (2), unlink(2), utime{ 2), and write (.2). 

Stat will fail if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path 

prefix. 
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[EFAULT] Buf or path points to an invalid address. 

Fstat will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[EFAULT] Buf points to an invalid address. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), read(2), time(2), 
unlink(2), utime(2), write(2). 
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NAME 

stime — set time 

SYNOPSIS 

int stime (tp) 
long *tp; 

DESCRIPTION 

Stime sets the system’s idea of the time and date. Tp points to the value of 
time as measured in seconds from 00:00:00 GMT January 1, 1970. 

[EPERM] Stime will fail if the effective user ID of the calling process is 

not super-user. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

time (2). 


- 1 - 



SYNC(2) 


SYNC (2) 


NAME 

sync — update super-block 

SYNOPSIS 

void sync ( ) 

DESCRIPTION 

Sync causes all information in memory that should be on disk to be written out. 
This includes modified super blocks, modified i-nodes, and delayed block I/O. 

It should be used by programs which examine a file system, for example fsck, 
df, etc. It is mandatory before a boot. 

The writing, although scheduled, is not necessarily complete upon return from 
sync. 
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NAME 

time — get time 
SYNOPSIS 

long time ((long •) 0) 

long time (tloc) 
long *tloc; 

DESCRIPTION 

Time returns the value of time in seconds since 00:00:00 GMT, January 1, 
1970. 

If tloc (taken as an integer) is non-zero, the return value is also stored in the 
location to which tloc points. 

[EFAULT] Time will fail if tloc points to an illegal address. 

RETURN VALUE 

Upon successful completion, time returns the value of time. Otherwise, a value 
of — 1 is returned and errno is set to indicate the error. 

SEE ALSO 

stime(2). 
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NAME 

times - get process and child process times 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/times.h> 

long times (buffer) 
struct tins ‘buffer; 

DESCRIPTION 

Times fills the structure pointed to by buffer with time-accounting information. 
The following are the contents of this structure: 


struct tms { 

time_t tms_utime; 
time_t tms_stime; 
timet tmscutime; 
time_t tms_cstime; 


This information comes from the calling process and each of its terminated 
child processes for which it has executed a wait. All times are in 60ths of a 
second on DEC processors, lOOths of a second on AT&T processors. 

Tmsutime is the CPU time used while executing instructions in the user space 
of the calling process. 


Tmsjtime is the CPU time used by the system on behalf of the calling process. 

Tms cutime is the sum of the tmsjutime s and tms cutime s of the child 
processes. 

Tmscstime is the sum of the tms slimes and t ms _cs times of the child 
processes. 


[EFAULT] Times will fail if buffer points to an illegal address. 

RETURN VALUE 

Upon successful completion, times returns the elapsed real time, in 60ths 
(lOOths) of a second, since an arbitrary point in the past (e.g., system start-up 
time). This point does not change from one invocation of times to another. If 
times fails, a —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec (2), fork(2), time(2), wait(2). 
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NAME 

ulimit — get and set user limits 

SYNOPSIS 

long ulimit (cmd, newlimit) 
int cmd; 
long newlimit; 

DESCRIPTION 

This function provides for control over process limits. The cmd values available 
are: 

1 Get the file size limit of the process. The limit is in units of 512-byte 
blocks and is inherited by child processes. Files of any size can be read. 

2 Set the file size limit of the process to the value of newlimit. Any process 
may decrease this limit, but only a process with an effective user ID of 
super-user may increase the limit. Ulimit will fail and the limit will be 
unchanged if a process with an effective user ID other than super-user 
attempts to increase its file size limit. [EPERM] 

3 Get the maximum possible break value. Seebrk(2). 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

brk(2), write(2). 
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NAME 

umask — set and get file creation mask 

SYNOPSIS 

int umask (cmask) 
int cmask; 

DESCRIPTION 

Umask sets the process’s file mode creation mask to cmask and returns the pre- 
vious value of the mask. Only the low-order 9 bits of cmask and the file mode 
creation mask are used. 

RETURN VALUE 

The previous value of the file mode creation mask is returned. 

SEE ALSO 

chmod(2), creat(2), mknod(2), open (2). 

mkdir(l), sh(l) in the UNIX System V User Reference Manual. 
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NAME 

umount — unmount a file system 

SYNOPSIS 

int umount (spec) 
char *spec; 

DESCRIPTION 

Umount requests that a previously mounted file system contained on the block 
special device identified by spec be unmounted. Spec is a pointer to a path 
name. After unmounting the file system, the directory upon which the file sys- 
tem was mounted reverts to its ordinary interpretation. 

Umount may be invoked only by the super-user. 

Umount will fail if one or more of the following are true: 

[EPERMl The process’s effective user ID is not super-user. 

[ENXIOl Spec does not exist. 

[ENOTBLK] Spec is not a block special device. 

[EINVAL] Spec is not mounted. 

[EBUSYl A file on spec is busy. 

[EFAULT] Spec points to an illegal address. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

mount (2). 
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NAME 

uname — get name of current UNIX system 
SYNOPSIS 

#include <sys/utsname.h> 

int uname (name) 
struct utsname 'name; 

DESCRIPTION 

Uname stores information identifying the current UNIX system in the structure 
pointed to by name. 

Uname uses the structure defined in <sys/utsname.h> whose members are: 

char sysname[9]; 
char nodename[9]; 
char release[9]; 
char version[9]; 
char machine[9l; 

Uname returns a null-terminated character string naming the current UNIX 
system in the character array sysname. Similarly, nodename contains the 
name that the system is known by on a communications network. Release and 
version further identify the operating system. Machine contains a standard 
name that identifies the hardware that the UNIX system is running on. 

[EFAULT] Uname will fail if name points to an invalid address. 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, -1 is 
returned and errno is set to indicate the error. 

SEE ALSO 

uname(l) in the UNIX System V User Reference Manual. 
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NAME 

unlink — remove directory entry 

SYNOPSIS 

int unlink (path) 
char 'path; 

DESCRIPTION 

Unlink removes the directory entry named by the path name pointed to be 
path. 

The named file is unlinked unless one or more of the following are true: 
[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

tEACCES] Search permission is denied for a component of the path 

prefix. 

[EACCES] Write permission is denied on the directory containing the link 

to be removed. 

[EPERM] The named file is a directory and the effective user ID of the 

process is not super-user. 

[EBUSY] The entry to be unlinked is the mount point for a mounted file 

system. 

[ETXTBSYl The entry to be unlinked is the last link to a pure procedure 
(shared text) file that is being executed. 

[EROFS] The directory entry to be unlinked is part of a read-only file 

system. 

[EFAULT] Path points outside the process’s allocated address space. 

When all links to a file have been removed and no process has the file open, the 
space occupied by the file is freed and the file ceases to exist. If one or more 
processes have the file open when the last link is removed, the removal is post- 
poned until all references to the file have been closed. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

close(2), link(2), open(2). 

rm(l) in the UNIX System V User Reference Manual. 
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NAME 

ustat — get file system statistics 
SYNOPSIS 

#include <sys/types.h> 

#include <ustat.h> 

int ustat (dev, buf) 
int dev; 

struct ustat »buf; 

DESCRIPTION 

Ustat returns information about a mounted file system. Dev is a device number 
identifying a device containing a mounted file system. Buf is a pointer to a 
ustat structure that includes to following elements: 

daddr_t f_tfree; /» Total free blocks »/ 

ino_t f_tinode; /* Number of free inodes */ 

char f_fname[6]; /» Filsys name »/ 

char f_fpack[6]; /» Filsys pack name */ 

Ustat will fail if one or more of the following are true: 

[EINVAL] Dev is not the device number of a device containing a 

mounted file system. 

[EFAULT] Buf points outside the process’s allocated address space. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

stat(2), fs(4). 
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NAME 

utime — set file access and modification times 
SYNOPSIS 

#include <sys/types.h> 
int utime (path, times) 
char ‘path; 
struct utimbuf *times; 

DESCRIPTION 

Path points to a path name naming a file. Utime sets the access and 
modification times of the named file. 

If times is NULL, the access and modification times of the file are set to the 
current time. A process must be the owner of the file or have write permission 
to use utime in this manner. 

If times is not NULL, times is interpreted as a pointer to a utimbuf structure 
and the access and modification times are set to the values contained in the 
designated structure. Only the owner of the file or the super-user may use 
utime this way. 

The times in the following structure are measured in seconds since 00:00:00 
GMT, Jan. 1, 1970. 

struct utimbuf ( 

time_t actime; /* access time »/ 
time_t modtime; /* modification time */ 

); 

Utime will fail if one or more of the following are true: 

[ENOENT] The named file does not exist. 

[ENOTDIR] A component of the path prefix is not a directory. 

[EACCESl Search permission is denied by a component of the path 

prefix. 

[EPERM] The effective user ID is not super-user and not the owner of 

the file and times is not NULL. 

[EACCESl The effective user ID is not super-user and not the owner of 

the file and times is NULL and write access is denied. 

[EROFS] The file system containing the file is mounted read-only. 

[EFAULT] Times is not NULL and points outside the process’s allocated 

address space. 

[EFAULT] Path points outside the process’s allocated address space. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 

SEE ALSO 

stat(2). 
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NAME 

wait — wait for child process to stop or terminate 
SYNOPSIS 

int wait (stat loc) 
int *statloc; 

int wait ((int »)0) 

DESCRIPTION 

Wait suspends the calling process until until one of the immediate children ter- 
minates or until a child that is being traced stops, because it has hit a break 
point. The wait system call will return prematurely if a signal is received and 
if a child process stopped or terminated prior to the call on wait, return is 
immediate. 

If stat loc (taken as an integer) is non-zero, 16 bits of information called 
status are stored in the low order 16 bits of the location pointed to by stat Joe. 
Status can be used to differentiate between stopped and terminated child 
processes and if the child process terminated, status identifies the cause of ter- 
mination and passes useful information to the parent. This is accomplished in 
the following manner: 

If the child process stopped, the high order 8 bits of status will contain 
the number of the signal that caused the process to stop and the low 
order 8 bits will be set equal to 0177. 

If the child process terminated due to an exit call, the low order 8 bits 
of status will be zero and the high order 8 bits will contain the low 
order 8 bits of the argument that the child process passed to exit; see 
exit (2) . 

If the child process terminated due to a signal, the high order 8 bits of 
status will be zero and the low order 8 bits will contain the number of 
the signal that caused the termination. In addition, if the low order 
seventh bit (i.e., bit 200) is set, a “core image” will have been pro- 
duced; see signal (2) . 

If a parent process terminates without waiting for its child processes to ter- 
minate, the parent process ID of each child process is set to 1. This means the 
initialization process inherits the child processes; see intro (.2). 

Wait will fail and return immediately if one or more of the following are true: 

[ECHILD] The calling process has no existing unwaited-for child 

processes. 

[EFAULT] Stat Joe points to an illegal address. 

RETURN VALUE 

If wait returns due to the receipt of a signal, a value of —1 is returned to the 
calling process and errno is set to EINTR. If wait returns due to a stopped or 
terminated child process, the process ID of the child is returned to the calling 
process. Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 

SEE ALSO 

exec (2), exit (2), fork (2), intro (2), pause (2), ptrace(2), signal (2). 

WARNING 

See WARNING in signal (2). 
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NAME 

write — write on a file 
SYNOPSIS 

int write (tildes, buf, nbyte) 
int Hides; 
char »buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe sys- 
tem call. 

Write attempts to write nbyte bytes from the buffer pointed to by buf to the 
file associated with the fildes. 

On devices capable of seeking, the actual writing of data proceeds from the 
position in the file indicated by the file pointer. Upon return from write, the 
file pointer is incremented by the number of bytes actually written. 

On devices incapable of seeking, writing always takes place starting at the 
current position. The value of a file pointer associated with such a device is 
undefined. 

If the O APPEND flag of the file status flags is set, the file pointer will be set to 
the end of the file prior to each write. 

Write will fail and the file pointer will remain unchanged if one or more of the 
following are true: 

[EBADFl Fildes is not a valid file descriptor open for writing. 

[EPIPE and SIGPIPE signal] 

An attempt is made to write to a pipe that is not open for 
reading by any process. 

[EFBIGl An attempt was made to write a file that exceeds the process’s 

file size limit or the maximum file size. See ulimit (2) . 

[EFAULT] Buf points outside the process’s allocated address space. 

[EINTR] A signal was caught during the write system call. 

If a write requests that more bytes be written than there is room for (e.g., the 
ulimit (see ulimit (2)) or the physical end of a medium), only as many bytes as 
there is room for will be written. For example, suppose there is space for 20 
bytes more in a file before reaching a limit. A write of 512 bytes will return 
20. The next write of a non-zero number of bytes will give a failure return 
(except as noted below). 

If the file being written is a pipe (or FIFO) and the ONDELAY flag of the file 
flag word is set, then write to a full pipe (or FIFO) will return a count of 0. 
Otherwise (ONDELAY clear), writes to a full pipe (or FIFO) will block until 
space becomes available. 

RETURN VALUE 

Upon successful completion the number of bytes actually written is returned. 
Otherwise, —1 is returned and errno is set to indicate the error. 

SEE ALSO 

creat (2), dup(2), lseek(2), open (2), pipe (2), ulimit (2). 
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NAME 

intro — introduction to subroutines and libraries 
SYNOPSIS 

#include <stdio.h> 

#include <math.h> 

DESCRIPTION 

This section describes functions found in various libraries, other than those 
functions that directly invoke UNIX system primitives, which are described in 
Section 2 of this volume. Certain major collections are identified by a letter 
after the section number: 

(3C) These functions, together with those of Section 2 and those marked 
(3S), constitute the Standard C Library libc, which is automatically 
loaded by the C compiler, cc(l). The link editor ld(\) searches this 
library under the -lc option. Declarations for some of these functions 
may be obtained from ^include files indicated on the appropriate pages. 
(3S) These functions constitute the “standard I/O package” (see stdioi 3S)). 
These functions are in the library libc, already mentioned. Declarations 
for these functions may be obtained from the #include file <stdio.h>. 
(3M) These functions constitute the Math Library, libm. They are automati- 
cally loaded as needed by the FORTRAN compiler /77( 1). They are not 
automatically loaded by the C compiler, cc(l); however, the link editor 
searches this library under the -Im option. Declarations for these func- 
tions may be obtained from the #include file <math.h>. Several gen- 
erally useful mathematical constants are also defined there (see 
math (5)). 

(3X) Various specialized libraries. The files in which these libraries are found 
are given on the appropriate pages. 

(3F) These functions constitute the FORTRAN intrinsic function library, 
libF77 . These functions are automatically available to the FORTRAN 
programmer and require no special invocation of the compiler. 

DEFINITIONS 

A character is any bit pattern able to fit into a byte on the machine. The null 
character is a character with value 0, represented in the C language as ’\0\ A 
character array is a sequence of characters. A null-terminated character 
array is a sequence of characters, the last of which is the null character. A 
string is a designation for a null -terminated character array. The null string 
is a character array containing only the null character. A NULL pointer is the 
value that is obtained by casting 0 into a pointer. The C language guarantees 
that this value will not match that of any legitimate pointer, so many functions 
that return pointers return it to indicate an error. NULL is defined as 0 in 
<stdio.h>; the user can include an appropriate definition if not using 
<stdio.h>. 

Many groups of FORTRAN intrinsic functions have generic function names that 
do not require explicit or implicit type declaration. The type of the function 
will be determined by the type of its argument (s). For example, the generic 
function max will return an integer value if given integer arguments ( maxO ), a 
real value if given real arguments ( amaxl ), or a double-precision value if given 
double-precision arguments {dmaxl) . 

FILES 

/lib/libc.a 

/lib/libm.a 

/usr/lib/libF77.a 
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SEE ALSO 

intro(2), stdio(3S), math(5). 

ar(l), cc(l), f77 (1) , ld(l), lint(l), nm(l) in the UNIX System V User Refer- 
ence Manual. 

DIAGNOSTICS 

Functions in the C and Math Libraries (3C and 3M) may return the conven- 
tional values 0 or ±HUGE (the largest-magnitude single-precision floating-point 
numbers; HUGE is defined in the <math.h> header file) when the function is 
undefined for the given arguments or when the value is not representable. In 
these cases, the external variable errno (see intro (2)) is set to the value EDOM 
or ERANGE. As many of the FORTRAN intrinsic functions use the routines 
found in the Math Library, the same conventions apply. 

WARNING 

Many of the functions in the libraries call and/or refer to other functions and 
external variables described in this section and in section 2 ( System Calls). If 
a program inadvertantly defines a function or external variable with the same 
name, the presumed library version of the function or external variable may not 
be loaded. The lint{ l) program checker reports name conflicts of this kind as 
“multiple declarations” of the names in question. Definitions for sections 2, 3C, 
and 3S are checked automatically. Other definitions can be included by using 
the -1 option (for example, -1 m includes definitions for the Math Library, sec- 
tion 3M). Use of lint is highly recommended. 
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NAME 

a641, 164a - convert between long integer and base-64 ASCII string 
SYNOPSIS 

long a641 (s) 
char *s; 

char «164a (1) 
long I; 

DESCRIPTION 

These functions are used to maintain numbers stored in base-64 ASCII charac- 
ters. This is a notation by which long integers can be represented by up to six 
characters; each character represents a “digit” in a radix-64 notation. 

The characters used to represent “digits” are . for 0, / for 1, 0 through 9 for 
2—11, A through Z for 12—37, and a through z for 38—63. 

A641 takes a pointer to a null-terminated base-64 representation and returns a 
corresponding long value. If the string pointed to by s contains more than six 
characters, a64l will use the first six. 

L64a takes a long argument and returns a pointer to the corresponding base-64 
representation. If the argument is 0, 164a returns a pointer to a null string. 

BUGS 

The value returned by 164a is a pointer into a static buffer, the contents of 
which are overwritten by each call. 
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NAME 

abort — generate an IOT fault 

SYNOPSIS 

int abort ( ) 

DESCRIPTION 

Abort first closes all open files if possible, then causes an IOT signal to be sent 
to the process. This usually results in termination with a core dump. 

It is possible for abort to return control if SIGIOT is caught or ignored, in which 
case the value returned is that of the kill(2) system call. 

SEE ALSO 

exit (2), kill (2), signal(2). 

adb(l), sdb(l) in the UNIX System V User Reference Manual. 

DIAGNOSTICS 

If SIGIOT is neither caught nor ignored, and the current directory is writable, a 
core dump is produced and the message “abort - core dumped” is written by 
the shell. 
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NAME 

abs — return integer absolute value 
SYNOPSIS 

int abs (i) 
int i; 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

BUGS 

In two’s-complement representation, the absolute value of the negative integer 
with largest magnitude is undefined. Some implementations trap this error, but 
others simply ignore it. 

SEE ALSO 

floor (3 M). 
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NAME 

bsearch — binary search a sorted table 

SYNOPSIS 

#include <search.h> 

char »bsearch ((char •) key, (char •) base, nel, sizeof (*key), compar) 

unsigned nel; 

int (*compar)( ); 

DESCRIPTION 

Bsearch is a binary search routine generalized from Knuth (6.2.1) Algorithm 
B. It returns a pointer into a table indicating where a datum may be found. 
The table must be previously sorted in increasing order according to a provided 
comparison function. Key points to a datum instance to be sought in the table. 
Base points to the element at the base of the table. Nel is the number of ele- 
ments in the table. Compar is the name of the comparison function, which is 
called with two arguments that point to the elements being compared. The 
function must return an integer less than, equal to, or greater than zero as 
accordingly the firstargument is to be considered less than, equal to, or greater 
than the second. 

EXAMPLE , . . , 

The example below searches a table containing pointers to nodes consisting ot a 
string and its length. The table is ordered alphabetically on the string in the 
node pointed to by each entry. 

This code fragment reads in strings and either finds the corresponding node and 
prints out the string and its length, or prints an error message. 

#include <stdio.h> 

#include < search. h> 

#define TABSIZE 1000 

struct node { 

char »string; 
int length; 

}; 

struct node tableiTABSIZEl; 


/* these are stored in the table »/ 


/» table to be searched */ 


struct node *node_ptr, node; 

int node_compare( ); /* routine to compare 2 nodes */ 

char str_space[20l; /* space to read string into */ 


node.string = strspace; 

while (scanf("%s'\ node.string) != EOF) { 

node_ptr = (struct node *) bsearch ((char »)(&node), 
(char »)table, TABSIZE, 
sizeof (struct node), nodecompare); 
if (node_ptr != NULL) ( 

(void) printf ("string = %>20s, length = %d\n", 
nodejDtr— > string, nodejDtr— > length) ; 

} else { 

(void) printf ("not found: %s\n", node.string); 
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/* 


This routine compares two nodes based on an 
alphabetical ordering of the string field. 

*/ 

int 

node_compare(nodel, node2) 
struct node *nodel, *node2; 

^ return strcmp(nodel->string, node2-> string); 

NOTES 

The pointers to the key and the element at the base of the table should be of 
type pointer-to-element, and cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be 
cast into type pointer-to-element. 

SEE ALSO 

hsearch(3C), lsearch(3C), qsort(3C), tsearch(3C). 

DIAGNOSTICS 

A NULL pointer is returned if the key cannot be found in the table. 
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NAME 

clock — report CPU time used 

SYNOPSIS 

long clock ( ) 

DESCRIPTION 

Clock returns the amount of CPU time (in microseconds) used since the first 
call to clock. The time reported is the sum of the user and system times of the 
calling process and its terminated child processes for which it has executed 
wait (2) or system (3S) . 

The resolution of the clock is 10 milliseconds on AT&T Technologies 3B com- 
puter processors, 16.667 milliseconds on Digital Equipment Corporation proces- 
sors. 

SEE ALSO 

times(2), wait(2), system(3S). 

BUGS 

The value returned by clock is defined in microseconds for compatibility with 
systems that have CPU clocks with much higher resolution. Because of this, 
the value returned will wrap around after accumulating only 2147 seconds of 
CPU time (about 36 minutes). 
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NAME 

toupper, tolower, Joupper, Jolower, toascii — translate characters 

SYNOPSIS 

#include <ctype.h> 

int toupper (c) 
int c; 

int tolower (c) 
int c; 

int Joupper (c) 
int c; 

int Jolower (c) 
int c; 

int toascii (c) 
int c; 

DESCRIPTION 

Toupper and tolower have as domain the range of getcl 3S): the integers from 
-1 through 255. If the argument of toupper represents a lower-case letter, the 
result is the corresponding upper-case letter. If the argument of tolower 
represents an upper-case letter, the result is the corresponding lower-case letter. 
All other arguments in the domain are returned unchanged. 

The macros Joupper and tolower, are macros that accomplish the same thing 
as toupper and tolower but have restricted domains and are faster, toupper 
requires a lower-case letter as its argument; its result is the corresponding 
upper-case letter. The macro Jolower requires an upper-case letter as its 
argument; its result is the corresponding lower-case letter. Arguments outside 
the domain cause undefined results. 

Toascii yields its argument with all bits turned off that are not part of a stan- 
dard ASCII character; it is intended for compatibility with other systems. 

SEE ALSO 

ctype(3C), getc(3S). 
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NAME 

crypt, setkey, encrypt — generate DES encryption 
SYNOPSIS 

char 'crypt (key, salt) 
char *key, *salt; 

void setkey (key) 
char *key; 

void encrypt (block, edflag) 
char 'block; 
int edflag; 

DESCRIPTION 

Crypt is the password encryption function. It is based on the NBS Data 
Encryption Standard (DES), with variations intended (among other things) to 
frustrate use of hardware implementations of the DES for key search. 

Key is a user’s typed password. Salt is a two-character string chosen from the 
set [a-zA-ZO-9./]; this string is used to perturb the DES algorithm in one of 
4096 different ways, after which the password is used as the key to encrypt 
repeatedly a constant string. The returned value points to the encrypted pass- 
word. The first two characters are the salt itself. 

The setkey and encrypt entries provide (rather primitive) access to the actual 
DES algorithm. The argument of setkey is a character array of length 64 con- 
taining only the characters with numerical value 0 and 1. If this string is 
divided into groups of 8, the low-order bit in each group is ignored; this gives a 
56-bit key which is set into the machine. This is the key that will be used with 
the above mentioned algorithm to encrypt or decrypt the string block with the 
function encrypt. 

The argument to the encrypt entry is a character array of length 64 containing 
only the characters with numerical value 0 and 1. The argument array is 
modified in place to a similar array representing the bits of the argument after 
having been subjected to the DES algorithm using the key set by setkey. If 
edflag is zero, the argument is encrypted; if non-zero, it is decrypted. 

SEE ALSO 

getpass(3C), passwd(4). 

login (1), passwd(l) in the UNIX System V User Reference Manual. 

BUGS 

The return value points to static data that are overwritten by each call. 
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NAME 

ctermid — generate file name for terminal 

SYNOPSIS 

#include <stdio.h> 
char •ctermid (s) 
char »s; 

DESCRIPTION 

Ctermid generates the path name of the controlling terminal for the current 
process, and stores it in a string. 

If i is a NULL pointer, the string is stored in an internal static area, the con- 
tents of which are overwritten at the next call to ctermid, and the address of 
which is returned. Otherwise, s is assumed to point to a character array of at 
least Lctermid elements; the path name is placed in this array and the value of 
s is returned. The constant L ctermid is defined in the <stdio.h> header file. 

NOTES 

The difference between ctermid and ttyname ( 3C) is that ttyname must be 
handed a file descriptor and returns the actual name of the terminal associated 
with that file descriptor, while ctermid returns a string (/dev/tty) that will 
refer to the terminal if used as a file name. Thus ttyname is useful only if the 
process already has at least one file open to a terminal. 

SEE ALSO 

ttyname(3C). 
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NAME 

ctime, localtime, gmtime, asctime, tzset — convert date and time to string 

SYNOPSIS 

#include <time.h> 

char *ctime (clock) 
long *clock; 

struct tm *localtime (clock) 
long *clock; 

struct tm *gmtime (clock) 
long *clock; 

char •asctime (tm) 
struct tm *tm; 

extern long timezone; 
extern int daylight; 
extern char •tzname(2l; 
void tzset ( ) 

DESCRIPTION 

Ctime converts a long integer, pointed to by clock, representing the time in 
seconds since 00:00:00 GMT, January 1, 1970, and returns a pointer to a 26- 
character string in the following form. All the fields have constant width. 

Sun Sep 16 01:03:52 1973\n\0 

Localtime and gmtime return pointers to “tm” structures, described below. 
Localtime corrects for the time zone and possible Daylight Savings Time; 
gmtime converts directly to Greenwich Mean Time (GMT), which is the time 
the UNIX system uses. 

Asctime converts a “tm” structure to a 26-character string, as shown in the 
above example, and returns a pointer to the string. 

Declarations of all the functions and externals, and the “tm” structure, are in 
the <time.h> header file. The structure declaration is: 

struct tm ( 


int tmsec; 

/* seconds (0 - 59) */ 

int tmmin; 

/* minutes (0 - 59) */ 

int tm_hour; 

/* hours (0 - 23) */ 

int tmmday; 

/* day of month (1 - 31) */ 

int tmmon; 

/* month of year (0 - 11) */ 

int tm_year; 

/* year — 1900 */ 

int tmwday; 

/* day of week (Sunday = 0) */ 

int tm_yday; 
int tmjsdst; 

/* day of year (0 - 365) */ 


}; 

Tmjsdst is non-zero if Daylight Savings Time is in effect. 

The external long variable timezone contains the difference, in seconds, between 
GMT and local standard time (in EST, timezone is 5*60*60) ; the external vari- 
able daylight is non-zero if and only if the standard U.S.A. Daylight Savings 
Time conversion should be applied. The program knows about the peculiarities 
of this conversion in 1974 and 1975; if necessary, a table for these years can be 
extended. 

If an environment variable named TZ is present, asctime uses the contents of 
the variable to override the default time zone. The value of TZ must be a 
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three-letter time zone name, followed by a number representing the difference 
between local time and Greenwich Mean Time in hours, followed by an 
optional three-letter name for a daylight time zone. For example, the setting 
for New Jersey would be EST5EDT. The effects of setting TZ are thus to 
change the values of the external variables timezone and daylight', in addition, 
the time zone names contained in the external variable 

char *tzname[2l = { "EST", "EDT" }; 

are set from the environment variable TZ. The function tzset sets these exter- 
nal variables from TZ; tzset is called by asctime and may also be called expli- 
citly by the user. 

Note that in most installations, TZ is set by default when the user logs on, to a 
value in the local /etc/profile file (see profile {A)). 

SEE ALSO 

time(2), getenv(3C), profile(4), environ(5). 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, 
isgraph, iscntrl, isascii — classify characters 

SYNOPSIS 

#include <ctype.h> 

int isalpha (c) 
int c; 

DESCRIPTION 

These macros classify character-coded integer values by table lookup. Each is 
a predicate returning nonzero for true, zero for false. Isascii is defined on all 
integer values; the rest are defined only where isascii is true and on the single 
non-ASCII value EOF (-1 - see stdioi 3S)). 

isalpha c is a letter. 

isupper c is an upper-case letter. 

islower c is a lower-case letter. 

isdigit c is a digit [0-9]. 

isxdigit c is a hexadecimal digit [0-9], [A-F] or [a-f]. 

isalnum c is an alphanumeric (letter or digit). 

isspace c is a space, tab, carriage return, new-line, vertical tab, or 

form-feed. 

ispunct c is a punctuation character (neither control nor 

alphanumeric). 

isprint c is a printing character, code 040 (space) through 0176 

(tilde) . 

isgraph c is a printing character, like isprint except false for space. 

iscntrl c is a delete character (0177) or an ordinary control character 

(less than 040). 

isascii c is an ASCII character, code less than 0200. 

DIAGNOSTICS 

If the argument to any of these macros is not in the domain of the function, the 
result is undefined. 

SEE ALSO 

stdio(3S), ascii(5). 
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NAME 

cuserid — get character login name of the user 
SYNOPSIS 

#include <stdio.h> 

char *cuserid (s) 
char »s; 

DESCRIPTION 

Cuserid generates a character-string representation of the login name that the 
owner of the current process is logged in under. If s is a NULL pointer, this 
representation is generated in an internal static area, the address of which is 
returned. Otherwise, j is assumed to point to an array of at least L cuserid 
characters; the representation is left in this array. The constant L cuserid is 
defined in the <stdio.h> header file. 

DIAGNOSTICS 

If the login name cannot be found, cuserid returns a NULL pointer; if j is not a 
NULL pointer, a null character (\0) will be placed at sfO], 

SEE ALSO 

getlogin(3C), getpwent(3C). 
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NAME 

dial - establish an out-going terminal line connection 

SYNOPSIS 

#include <dial.h> 

int dial (call) 

CALL call; 

void undial (fd) 
int fd; 

DESCRIPTION . 

Dial returns a file-descriptor for a terminal line open for read/ write. The argu- 
ment to dial is a CALL structure (defined in the <dial.h> header file). 

When finished with the terminal line, the calling program must invoke undial 
to release the semaphore that has been set during the allocation of the terminal 
device. 

The definition of CALL in the <dial.h> header file is: 
typedef struct ( 

struct termio »attr; /* pointer to termio attribute struct */ 

int baud; /* transmission data rate */ 

int speed; /» 212A modem: low=300, high=T200 */ 

char *line; /* device name for out-going line */ 

char *telno; /* pointer to tel-no digits string */ 

int modem; /* specify modem control for direct lines */ 

char *device; /* Will hold the name of the device used 

to make a connection */ 

int devjen; /* The length of the device used to make 

} CALL; connection */ 

The CALL element speed is intended only for use with an outgoing dialed call, 
in which case its value should be either 300 or 1 200 to identify the 1 1 3 A 
modem, or the high- or low-speed setting on the 212A modem. Note that the 
1 13A modem or the low-speed setting of the 21 2A modem will transmit at any 
rate between 0 and 300 bits per second. However, the high-speed setting of the 
212A modem transmits and receivers at 1200 bits per secound only. The CALL 
element baud is for the desired transmission baud rate. For example, one 
might set baud to 110 and speed to 300 (or 1200). However, if speed set to 
1200 baud must be set to high (1200). 

If the desired terminal line is a direct line, a string pointer to its device-name 
should be placed in the line element in the CALL structure. Legal values for 
such terminal device names are kept in the L-devices file. In this case, the 
value of the baud element need not be specified as it will be determined from 
the L-devices file. 

The telno element is for a pointer to a character string representing the tele- 
phone number to be dialed. Such numbers may consist only of symbols 
described on the acu( 7). The termination symbol will be supplied by the dial 
function, and should not be included in the telno string passed to dial in the 
CALL structure. 

The CALL element modem is used to specify modem control for direct lines. 
This element should be non-zero if modem control is required. The CALL ele- 
ment attr is a pointer to a termio structure, as defined in the termio.h header 
file. A NULL value for this pointer element may be passed to the dial function, 
but if such a structure is included, the elements specified in it will be set for 
the outgoing terminal line before the connection is established. This is often 
important for certain attributes such as parity and baud-rate. 
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The CALL element device is used to hold the device name (cul..) that estab- 
lishes the connection. 

The CALL element dev Jen is the length of the device name that is copied into 
the array device. 

FILES 

/usr/lib/ uucp/L-devices 
/ usr/spool/uucp/LCK.. ftp -device 

SEE ALSO 

uucp (1C) in the UNIX System V User Reference Manual. 
alarm (2), read (2), write (2). 

acu(7), termio(7) in the UNIX System V Administrator Reference Manual. 
DIAGNOSTICS 

On failure, a negative value indicating the reason for the failure will be 
returned. Mnemonics for these negative indices as listed here are defined in the 
<dial.h> header file. 


INTRPT 

-1 

/» interrupt occurred */ 

DHUNG 

-2 

/* dialer hung (no return from write) */ 

NOANS 

-3 

/* no answer within 10 seconds */ 

ILLBD 

-4 

/« illegal baud-rate */ 

APROB 

-5 

/* acu problem (openO failure) */ 

L PROB 

-6 

/» line problem (openO failure) */ 

NOLdv 

-7 

/* can’t open LDEVS file »/ 

DVNTA 

-8 

/* requested device not available */ 

DVNTK 

-9 

/• requested device not known */ 

NO BD_A 

-10 

/* no device available at requested baud */ 

NO BD K 

-11 

/* no device known at requested baud */ 


WARNINGS 

Including the <dial.h> header file automatically includes the <termio.h> 
header file. 

The above routine uses <stdio.h>, which causes it to increase the size of pro- 
grams, not otherwise using standard I/O, more than might be expected. 

BUGS 

An alarmi 2) system call for 3600 seconds is made (and caught) within the 
dial module for the purpose of “touching” the LCK.. file and constitutes the 
device allocation semaphore for the terminal device. Otherwise, uucp(lC) may 
simply delete the LCK.. entry on its 90-minute clean-up rounds. The alarm 
may go off while the user program is in a read (2) or write (2) system call, 
causing an apparent error return. If the user program expects to be around for 
an hour or more, error returns from reads should be checked for 
(errno= =EINTR), and the read possibly reissued. 
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NAME 

drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, 
lcong48 — generate uniformly distributed pseudo-random numbers 

SYNOPSIS 

double drand48 ( ) 

double erand48 (xsubi) 
unsigned short xsubi[3l; 

long lrand48 ( ) 

long nrand48 (xsubi) 
unsigned short xsubi[3l; 

long mrand48 ( ) 

long jrand48 (xsubi) 
unsigned short xsubi[3l; 

void srand48 (seedval) 
long seedval; 

unsigned short *seed48 (seed!6v) 
unsigned short seedl6v[3l; 

void lcong48 (param) 
unsigned short param[7l; 

DESCRIPTION 

This family of functions generates pseudo-random numbers using the well- 
known linear congruential algorithm and 48-bit integer arithmetic. 

Functions drand48 and erand48 return non-negative double-precision floating- 
point values uniformly distributed over the interval [0.0, 1.0). 

Functions lrand48 and nrand48 return non-negative long integers uniformly 
distributed over the interval [0, 2 31 ). 

Functions mrand48 and jrand48 return signed long integers uniformly distri- 
buted over the interval [— 2 31 , 2 31 ). 

Functions srand48, seed48 and lcong48 are initialization entry points, one of 
which should be invoked before either drand48, lrand48 or mrand48 is called. 
(Although it is not recommended practice, constant default initializer values 
will be supplied automatically if drand48, lrand48 or mrand48 is called 
without a prior call to an initialization entry point.) Functions erand48, 
nrand48 and jrand48 do not require an initialization entry point to be called 
first. 

All the routines work by generating a sequence of 48-bit integer values. A - ,-, 
according to the linear congruential formula 

3f n +i (,aX n -F c ) mo d m n^O. 

The parameter m= 2 48 ; hence 48-bit integer arithmetic is performed. Unless 
lcong48 has been invoked, the multiplier value a and the addend value c are 
given by 

a = 5DEECE66D 16 = 273673 1631 55 8 
c = Bi6 = 13 8 - 

The value returned by any of the functions drand48, erand48, lrand48, 
nrand48, mrand48 or jrand48 is computed by first generating the next 48-bit 
Xj in the sequence. Then the appropriate number of bits, according to the type 
of data item to be returned, are copied from the high-order (leftmost) bits of 
Xj and transformed into the returned value. 
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The functions drand48, lrand48 and mrand48 store the last 48-bit X, gen- 
erated in an internal buffer; that is why they must be initialized prior to being 
invoked. The functions erand48, nrand48 and jrand48 require the calling pro- 
gram to provide storage for the successive X t values in the array specified as an 
argument when the functions are invoked. That is why these routines do not 
have to be initialized; the calling program merely has to place the desired ini- 
tial value of Xj into the array and pass it as an argument. By using different 
arguments, functions erand48, nrand48 and jrand48 allow separate modules of 
a large program to generate several independent streams of pseudo-random 
numbers, i.e., the sequence of numbers in each stream will not depend upon 
how many times the routines have been called to generate numbers for the 
other streams. 

The initializer function srand48 sets the high-order 32 bits of X t to the 32 bits 
contained in its argument. The low-order 16 bits of Xj are set to the arbitrary 
value 330 Ei 6 . 

The initializer function seed48 sets the value of X , to the 48-bit value specified 
in the argument array. In addition, the previous value of Xj is copied into a 
48-bit internal buffer, used only by seed48, and a pointer to this buffer is the 
value returned by seed48. This returned pointer, which can just be ignored if 
not needed, is useful if a program is to be restarted from a given point at some 
future time — use the pointer to get at and store the last X t value, and then 
use this value to reinitialize via seed48 when the program is restarted. 

The initialization function lcong48 allows the user to specify the initial X the 
multiplier value a, and the addend value c. Argument array elements 
param[0-2] specify X it param[3-5] specify the multiplier a, and param[6] 
specifies the 16-bit addend c. After lcong48 has been called, a subsequent call 
to either srand48 or seed48 will restore the “standard” multiplier and addend 
values, a and c, specified on the previous page. 

NOTES 

The versions of these routines for the VAX-1 1 and PDP-11 are coded in assem- 
bly language for maximum speed. It requires approximately 80 msec on a 
VAX-11/780 and 130 psec on a PDP-11/70 to generate one pseudo-random 
number. On other computers, the routines are coded in portable C. The 
source code for the portable version can even be used on computers which do 
not have floating-point arithmetic. In such a situation, functions drand48 and 
erand48 do not exist; instead, they are replaced by the two new functions 
below. 

long irand48 (m) 
unsigned short m; 

long krand48 (xsubi, m) 
unsigned short xsubi[3l, m; 

Functions irand48 and krand48 return non-negative long integers uniformly 
distributed over the interval [0, m — 1]. 

SEE ALSO 

rand(3C). 


- 2 - 



ECVT(3C) 


ECVT(3C) 


NAME 

ecvt, fcvt, gcvt — convert floating-point number to string 
SYNOPSIS 

char *ecvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *fcvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, »sign; 

char »gcvt (value, ndigit, buf) 
double value; 
int ndigit; 
char *buf; 

DESCRIPTION 

Ecvt converts value to a null-terminated string of ndigit digits and returns a 
pointer thereto. The high-order digit is non-zero, unless the value is zero. The 
low-order digit is rounded. The position of the decimal point relative to the 
beginning of the string is stored indirectly through decpt (negative means to 
the left of the returned digits). The decimal point is not included in the 
returned string. If the sign of the result is negative, the word pointed to by 
sign is non-zero, otherwise it is zero. 

Fcvt is identical to ecvt, except that the correct digit has been rounded for 
printf “%F’ (FORTRAN F-format) output of the number of digits specified by 
ndigit. 

Gcvt converts the value to a null-terminated string in the array pointed to by 
buf and returns buf. It attempts to produce ndigit significant digits in FOR- 
TRAN F-format if possible, otherwise E-format, ready for printing. A minus 
sign, if there is one, or a decimal point will be included as part of the returned 
string. Trailing zeros are suppressed. 

SEE ALSO 

printf(3S). 

BUGS 

The values returned by ecvr and fcvt point to a single static data array whose 
content is overwritten by each call. 
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NAME 

end, etext, edata — last locations in program 

SYNOPSIS 

extern end; 
extern etext; 
extern edata; 

DESCRIPTION 

These names refer neither to routines nor to locations with interesting contents. 
The address of etext is the first address above the program text, edata above 
the initialized data region, and end above the uninitialized data region. 

When execution begins, the program break (the first location beyond the data) 
coincides with end , but the program break may be reset by the routines of 
brk( 2), malloci. 3C), standard input/output (stdioO S)), the profile (— p) 
option of cc(l), and so on. Thus, the current value of the program break 
should be determined by sbrk(O) (see brk( 2)). 

SEE ALSO 

brk(2), malloc(3C), stdio(3S). 

cc(l) in the UNIX System V User Reference Manual. 
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NAME 

fclose, fflush — close or flush a stream 

SYNOPSIS 

#include <stdio.h> 

int fclose (stream) 

FILE ‘stream; 

int fflush (stream) 

FILE ‘Stream; 

DESCRIPTION 

Fclose causes any buffered data for the named stream to be written out, and 
the stream to be closed. 

Fclose is performed automatically for all open files upon calling exit (2). 

Fflush causes any buffered data for the named stream to be written to that file. 
The stream remains open. 

DIAGNOSTICS 

These functions return 0 for success, and EOF if any error (such as trying to 
write to a file that has not been opened for writing) was detected. 

SEE ALSO 

close(2), exit(2), fopen(3S), setbuf(3S). 
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NAME 

ferror, feof, clearerr, fileno — stream status inquiries 

SYNOPSIS 

#include <stdio.h> 

int ferror (stream) 

FILE *stream; 

int feof (stream) 

FILE ‘stream; 

void clearerr (stream) 

FILE ‘stream; 

int fileno (stream) 

FILE ‘stream; 

DESCRIPTION 

Ferror returns non-zero when an I/O error has previously occurred reading 
from or writing to the named stream , otherwise zero. 

Feof returns non-zero when EOF has previously been detected reading the 
named input stream, otherwise zero. 

Clearerr resets the error indicator and EOF indicator to zero on the named 
stream . 

Fileno returns the integer file descriptor associated with the named stream', see 
open (2) . 

NOTE 

All these functions are implemented as macros; they cannot be declared or 
redeclared. 

SEE ALSO 

open (2), fopen(3S). 


- 1 - 



FOPEN (3S) 


FOPEN (3S) 


NAME 

fopen, freopen, fdopen — open a stream 

SYNOPSIS 

#include <stdio.h> 

FILE *fopen (file-name, type) 
char •file-name, »type; 

FILE »freopen (file-name, type, stream) 
char ‘file-name, ‘type; 

FILE ‘stream; 

FILE ‘fdopen (Aides, type) 
int Aides; 
char ‘type; 

DESCRIPTION 

Fopen opens the file named by file-name and associates a stream with it. 
Fopen returns a pointer to the FILE structure associated with the stream. 

File-name points to a character string that contains the name of the file to be 
opened. 


Type is a character 

string having one of the following values: 

V 

open for reading 

"w" 

truncate or create for writing 

"a" 

append; open for writing at end of file, or create for writing 

"r+" 

open for update (reading and writing) 

"w+" 

truncate or create for update 

"a+" 

append; open or create for update at end-of-file 


Freopen substitutes the named file in place of the open stream. The original 
stream is closed, regardless of whether the open ultimately succeeds. Freopen 
returns a pointer to the FILE structure associated with stream. 

Freopen is typically used to attach the preopened streams associated with stdin, 
stdout and stderr to other files. 

Fdopen associates a stream with a file descriptor. File descriptors are obtained 
from open, dup, creat , or piped), which open files but do not return pointers 
to a FILE structure stream. Streams are necessary input for many of the Sec- 
tion 3S library routines. The type of stream must agree with the mode of the 
open file. 

When a file is opened for update, both input and output may be done on the 
resulting stream. However, output may not be directly followed by input 
without an intervening fseek or rewind, and input may not be directly followed 
by output without an intervening fseek, rewind, or an input operation which 
encounters end-of-file. 

When a file is opened for append (i.e., when type is "a" or "a+''), it is impossi- 
ble to overwrite information already in the file. Fseek may be used to reposi- 
tion the file pointer to any position in the file, but when output is written to the 
file, the current file pointer is disregarded. All output is written at the end of 
the file and causes the file pointer to be repositioned at the end of the output. 
If two separate processes open the same file for append, each process may write 
freely to the file without fear of destroying output being written by the other. 
The output from the two processes will be intermixed in the file in the order in 
which it is written. 
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SEE ALSO 

creat(2), dup(2), open(2), pipe(2), fclose(3S), fseek(3S). 
DIAGNOSTICS 

Fopen and freopen return a NULL pointer on failure. 
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NAME 

fread, fwrite — binary input/output 

SYNOPSIS 

#include <stdio.h> 

int fread (ptr, size, nitems, stream) 

char «ptr; 

int size, nitems; 

FILE ‘stream; 

int fwrite (ptr, size, nitems, stream) 

char »ptr; 

int size, nitems; 

FILE ‘stream; 

DESCRIPTION 

Fread copies, into an array pointed to by ptr, nitems items of data from the 
named input stream, where an item of data is a sequence of bytes (not neces- 
sarily terminated by a null byte) of length size. Fread stops appending bytes if 
an end-of-file or error condition is encountered while reading stream, or if 
nitems items have been read. Fread leaves the file pointer in stream, if 
defined, pointing to the byte following the last byte read if there is one. Fread 
does not change the contents of stream. 

Fwrite appends at most nitems items of data from the array pointed to by ptr 
to the named output stream. Fwrite stops appending when it has appended 
nitems items of data or if an error condition is encountered on stream. Fwrite 
does not change the contents of the array pointed to by ptr. 

The argument size is typically sizeof(*ptr) where the pseudo-function sizeof 
specifies the length of an item pointed to by ptr. If ptr points to a data type 
other than char it should be cast into a pointer to char. 

SEE ALSO 

read(2), write(2), fopen(3S), getc(3S), gets(3S), printf(3S), putc(3S), 
puts(3S), scanf(3S). 

DIAGNOSTICS 

Fread and fwrite return the number of items read or written. If size or nitems 
is non-positive, no characters are read or written and 0 is returned by both 
fread and fwrite. 

BUGS 

On the PDP-11, the number of bytes transferred is the product of size and 
nitems, modulo 65536. 
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NAME 

frexp, ldexp, modf — manipulate parts of floating-point numbers 
SYNOPSIS 

double frexp (value, eptr) 
double value; 
int «eptr; 

double ldexp (value, exp) 
double value; 
int exp; 

double modf (value, iptr) 
double value, »iptr; 

DESCRIPTION 

Every non-zero number can be written uniquely as x* 2”, where the “mantissa” 
(fraction) x is in the range 0.5 < |x| < 1.0, and the “exponent” n is an 
integer. Frexp returns the mantissa of a double value, and stores the exponent 
indirectly in the location pointed to by eptr. If value is zero, both results 
returned by frexp are zero. 

Ldexp returns the quantity value * 2 exp . 

Modf returns the signed fractional part of value and stores the integral part 
indirectly in the location pointed to by iptr. 

DIAGNOSTICS 

If ldexp would cause overflow, ±HUGE is returned (according to the sign of 
value), and errno is set to ERANGE. 

If ldexp would cause underflow, zero is returned and errno is set to ERANGE. 
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NAME 

fseek, rewind, ftell — reposition a file pointer in a stream 

SYNOPSIS 

#include <stdio.h> 

int fseek (stream, offset, ptrname) 

FILE ‘Stream; 
long offset; 
int ptrname; 

void rewind (stream) 

FILE ‘stream; 

long ftell (stream) 

FILE ‘stream; 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream. 
The new position is at the signed distance offset bytes from the beginning, from 
the current position, or from the end of the file, according as ptrname has the 
value 0, 1, or 2. 

Rewind (stream) is equivalent to fseek(stream , 0L, 0), except that no value is 
returned. 

Fseek and rewind undo any effects of ungetc( 3S). 

After fseek or rewind, the next operation on a file opened for update may be 
either input or output. 

Ftell returns the offset of the current byte relative to the beginning of the file 
associated with the named stream. 

SEE ALSO 

lseek(2), fopen(3S), popen(3S), ungetc(3S). 

DIAGNOSTICS 

Fseek returns non-zero for improper seeks, otherwise zero. An improper seek 
can be, for example, an fseek done on a file that has not been opened via fopen\ 
in particular, fseek may not be used on a terminal, or on a file opened via 
popen (3S) . 

WARNING 

Although on the UNIX system an offset returned by ftell is measured in bytes, 
and it is permissible to seek to positions relative to that offset, portability to 
non-UNIX systems requires that an offset be used by fseek directly. Arithmetic 
may not meaningfully be performed on such an offset, which is not necessarily 
measured in bytes. 
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NAME 

ftw — walk a file tree 

SYNOPSIS 

#include <ftw.h> 

int ftw (path, fn, depth) 
char *path; 
int (*fn) ( ); 
int depth; 

DESCRIPTION 

Ftw recursively descends the directory hierarchy rooted in path. For each 
object in the hierarchy, ftw calls fn, passing it a pointer to a null-terminated 
character string containing the name of the object, a pointer to a stat structure 
(see stat (2)) containing information about the object, and an integer. Possible 
values of the integer, defined in the <ftw.h> header file, are FTW F for a file, 
FTWD for a directory, FTWDNR for a directory that cannot be read, and 
FTWNS for an object for which stat could not successfully be executed. If the 
integer is FTW DNR, descendants of that directory will not be processed. If the 
integer is FTW NS, the stat structure will contain garbage. An example of an 
object that would cause FTW NS to be passed to fn would be a file in a direc- 
tory with read but without execute (search) permission. 

Ftw visits a directory before visiting any of its descendants. 

The tree traversal continues until the tree is exhausted, an invocation of fn 
returns a nonzero value, or some error is detected within ftw (such as an I/O 
error). If the tree is exhausted, ftw returns zero. If fn returns a nonzero value, 
ftw stops its tree traversal and returns whatever value was returned by fn. If 
ftw detects an error, it returns —1, and sets the error type in errno. 

Ftw uses one file descriptor for each level in the tree. The depth argument 
limits the number of file descriptors so used. If depth is zero or negative, the 
effect is the same as if it were 1. Depth must not be greater than the number 
of file descriptors currently available for use. Ftw will run more quickly if 
depth is at least as large as the number of levels in the tree. 

SEE ALSO 

stat(2), malloc(3C). 

BUGS 

Because ftw is recursive, it is possible for it to terminate with a memory fault 
when applied to very deep file structures. 

It could be made to run faster and use less storage on deep structures at the 
cost of considerable complexity. 

Ftw uses malloci 3C) to allocate dynamic storage during its operation. If ftw is 
forcibly terminated, such as by longjmp being executed by fn or an interrupt 
routine, ftw will not have a chance to free that storage, so it will remain per- 
manently allocated. A safe way to handle interrupts is to store the fact that an 
interrupt has occurred, and arrange to have fn return a nonzero value at its 
next invocation. 
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NAME 

getc, getchar, fgetc, getw — get character or word from a stream 

SYNOPSIS 

#include <stdio.h> 

int getc (stream) 

FILE ‘stream; 

int getchar () 

int fgetc (stream) 

FILE ‘stream; 

int getw (stream) 

FILE ‘stream; 

DESCRIPTION 

Getc returns the next character (i.e., byte) from the named input stream , as an 
integer. It also moves the file pointer, if defined, ahead one character in 
stream. Getchar is defined as getc(stdin) . Getc and getchar are macros. 

Fgetc behaves like getc, but is a function rather than a macro. Fgetc runs 
more slowly than getc, but it takes less space per invocation and its name can 
be passed as an argument to a function. 

Getw returns the next word (i.e., integer) from the named input stream. Getw 
increments the associated file pointer, if defined, to point to the next word. The 
size of a word is the size of an integer and varies from machine to machine. 
Getw assumes no special alignment in the file. 

SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), scanf(3S). 
DIAGNOSTICS 

These functions return the constant EOF at end-of-file or upon an error. 
Because EOF is a valid integer, ferror (3S) should be used to detect getw errors. 

WARNING 

If the integer value returned by getc, getchar, or fgetc is stored into a character 
variable and then compared against the integer constant EOF, the comparison 
may never succeed, because sign-extension of a character on widening to 
integer is machine-dependent. 

BUGS 

Because it is implemented as a macro, getc treats incorrectly a stream argu- 
ment with side effects. In particular, getc(*f++) does not work sensibly. 
Fgetc should be used instead. 

Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent, and may not be read using getw on a 
different processor. 
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NAME 

getcwd — get path-name of current working directory 
SYNOPSIS 

char *getcwd (buf, size) 
char »buf; 
int size; 

DESCRIPTION 

Getcwd returns a pointer to the current directory path-name. The value of size 
must be at least two greater than the length of the path-name to be returned. 

If buf is a NULL pointer, getcwd will obtain size bytes of space using 
malloci 3C). In this case, the pointer returned by getcwd may be used as the 
argument in a subsequent call to free. 

The function is implemented by using popenOS ) to pipe the output of the 
pwd(l) command into the specified string space. 

EXAMPLE 

char *cwd, ‘getcwd 0; 


if ((cwd = getcwd((char *)NULL, 64)) == NULL) { 
perror(“pwd”); 
exit(l); 

} 

printf(“%s\n”, cwd); 

SEE ALSO 

malloc(3C), popen(3S). 

pwd(l) in the UNIX System V User Reference Manual. 

DIAGNOSTICS 

Returns NULL with errno set if size is not large enough, or if an error ocurrs in 
a lower-level function. 
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NAME 

getenv — return value for environment name 

SYNOPSIS 

char «getenv (name) 
char »name; 

DESCRIPTION 

Getenv searches the environment list (see environ (5)) for a string of the form 
name = value, and returns a pointer to the value in the current environment if 
such a string is present, otherwise a NULL pointer. 

SEE ALSO 

exec(2), putenv(3C), environ(5). 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent — get group file 
entry 

SYNOPSIS 

#include <grp.h> 

struct group »getgrent ( ) 

struct group ‘getgrgid (gid) 
int gid; 

struct group •getgrnam (name) 
char •name; 

void setgrent ( ) 
void endgrent ( ) 

struct group ‘fgetgrent (f) 

FILE *f; 

DESCRIPTION 

Getgrent, getgrgid and getgrnam each return pointers to an object with the fol- 
lowing structure containing the broken-out fields of a line in the /etc/group file. 
Each line contains a “group” structure, defined in the <grp.h> header file. 

struct group { 

char *gr_name; /• the name of the group •/ 

char »gr_passwd; /• the encrypted group password •/ 

int gr_gid; /• the numerical group ID •/ 

char **gr_mem; /• vector of pointers to member names •/ 

Getgrent when first called returns a pointer to the first group structure in the 
file; thereafter, it returns a pointer to the next group structure in the file; so, 
successive calls may be used to search the entire file. Getgrgid searches from 
the beginning of the file until a numerical group id matching gid is found and 
returns a pointer to the particular structure in which it was found. Getgrnam 
searches from the beginning of the file until a group name matching name is 
found and returns a pointer to the particular structure in which it was found. 
If an end-of-file or an error is encountered on reading, these functions return a 
NULL pointer. 

A call to setgrent has the effect of rewinding the group file to allow repeated 
searches. Endgrent may be called to close the group file when processing is 
complete. 

Fgetgrent returns a pointer to the next group structure in the stream /, which 
matches the format of /etc/group. 

FILES 

/etc/group 
SEE ALSO 

getlogin(3C), getpwent(3C), group(4). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 

BUGS 

All information is contained in a static area, so it must be copied if it is to be 
saved. 
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NAME 

getlogin — get login name 

SYNOPSIS 

char 'getlogin ( ); 

DESCRIPTION 

Getlogin returns a pointer to the login name as found in /etc/utmp. It may be 
used in conjunction with getpwnam to locate the correct password file entry 
when the same user ID is shared by several login names. 

If getlogin is called within a process that is not attached to a terminal, it 
returns a NULL pointer. The correct procedure for determining the login name 
is to call cuserid, or to call getlogin and if it fails to call getpwuid. 

FILES 

/etc/utmp 
SEE ALSO 

cuserid(3S), getgrent(3C), getpwent(3C), utmp(4). 

DIAGNOSTICS 

Returns the NULL pointer if name is not found. 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

getopt — get option letter from argument vector 
SYNOPSIS 

int getopt (argc, argv, optstring) 
int argc; 

char **argv, »opstring; 

extern char «optarg; 
extern int optind, opterr; 

DESCRIPTION 

Getopt returns the next option letter in argv that matches a letter in optstring. 
Optstring is a string of recognized option letters; if a letter is followed by a 
colon, the option is expected to have an argument that may or may not be 
separated from it by white space. Optarg is set to point to the start of the 
option argument on return from getopt. 

Getopt places in optind the argv index of the next argument to be processed. 
Because optind is external, it is normally initialized to zero automatically 
before the first call to getopt. 

When all options have been processed (i.e., up to the first non-option argu- 
ment), getopt returns EOF. The special option may be used to delimit the 

end of the options; EOF will be returned, and will be skipped. 

DIAGNOSTICS 

Getopt prints an error message on stderr and returns a question mark (?) when 
it encounters an option letter not included in optstring. This error message 
may be disabled by setting opterr to a non-zero value. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a 
command that can take the mutually exclusive options a and b, and the options 
f and o, both of which require arguments: 

main (argc, argv) 
int argc; 
char »*argv; 

{ 

int c; 

extern char *optarg; 
extern int optind; 


while ((c = getopt (argc, argv, "abf:o:")) != EOF) 
switch (c) ( 
case 'a': 

if (bflg) 

errflgH — F; 

else 

aflg++; 

break; 

case 'b': 


if (aflg) 


else 


case T : 


break; 


errflg++; 
bproc( ); 


ifile = optarg; 
break; 
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case 'o': 

ofile = optarg; 
break; 

case 

errflg++; 

} 

if (errflg) { 

fprintffstderr, "usage: 
exit (2); 

} 

for ( ; optind < argc; optind++) { 
if (access(argv[optind], 4)) { 

1 

SEE ALSO 

getopt(l) in the UNIX System V User Reference Manual. 
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NAME 

getpass — read a password 
SYNOPSIS 

char *getpass (prompt) 
char (prompt; 

DESCRIPTION 

Getpass reads up to a newline or EOF from the file /dev /tty, after prompting on 
the standard error output with the null-terminated string prompt and disabling 
echoing. A pointer is returned to a null-terminated string of at most 8 charac- 
ters. If /dev/tty cannot be opened, a NULL pointer is returned. An interrupt 
will terminate input and send an interrupt signal to the calling program before 
returning. 

FILES 

/dev/tty 

SEE ALSO 

crypt (3C). 

WARNING 

The above routine uses <stdio.h>, which causes it to increase the size of pro- 
grams not otherwise using standard I/O, more than might be expected. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

getpw — get name from UID 

SYNOPSIS 

int getpw (uid, buf) 
int uid; 
char *buf; 

DESCRIPTION 

Getpw searches the password file for a user id number that equals uid, copies 
the line of the password file in which uid was found into the array pointed to 
by buf, and returns 0. Getpw returns non-zero if uid cannot be found. 

This routine is included only for compatibility with prior systems and should 
not be used; see getpwentfSC) for routines to use instead. 

FILES 

/etc/passwd 
SEE ALSO 

getpwent(3C), passwd(4). 

DIAGNOSTICS 

Getpw returns non-zero on error. 

WARNING 

The above routine uses <stdio.h>, which causes it to increase, more than 
might be expected, the size of programs not otherwise using standard I/O. 
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NAME 

getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent — get password 
file entry 

SYNOPSIS 

#include <pwd.h> 

struct passwd *getpwent ( ) 

struct passwd *getpwuid (uid) 
int uid; 

struct passwd 'getpwnam (name) 
char *name; 

void setpwent ( ) 
void endpwent ( ) 

struct passwd 'fgetpwent (f) 

FILE 'f; 

DESCRIPTION 

Getpwent , getpwuid and getpwnam each returns a pointer to an object with the 
following structure containing the broken-out fields of a line in the /etc/passwd 
file. Each line in the file contains a “passwd” structure, declared in the 
<pwd.h> header file: 

struct passwd { 


char 

'pw_name; 

char 

'pw_passwd; 

int 

pw_uid; 

int 

pw_gid; 

char 

*pw_age; 

char 

♦pwcomment; 

char 

•pwjgecos; 

char 

»pw_dir; 

char 

»pw_shell; 


This structure is declared in <pwd.h> so it is not necessary to redeclare it. 

The pwcomment field is unused; the others have meanings described in 
passwd (4) . 

Getpwent when first called returns a pointer to the first passwd structure in the 
file; thereafter, it returns a pointer to the next passwd structure in the file; so 
successive calls can be used to search the entire file. Getpwuid searches from 
the beginning of the file until a numerical user id matching uid is found and 
returns a pointer to the particular structure in which it was found. Getpwnam 
searches from the beginning of the file until a login name matching name is 
found, and returns a pointer to the particular structure in which it was found. 
If an end-of-file or an error is encountered on reading, these functions return a 
NULL pointer. 

A call to setpwent has the effect of rewinding the password file to allow 
repeated searches. Endpwent may be called to close the password file when 
processing is complete. 

Fgetpwent returns a pointer to the next passwd structure in the stream /, which 
matches the format of /etc/passwd. 

FILES 

/etc/passwd 
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SEE ALSO 

getlogin(3C), getgrent(3C), passwd(4). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 

BUGS 

All information is contained in a static area, so it must be copied if it is to be 
saved. 


- 2 - 



GETSC3S) 


GETS (3S) 


NAME 

gets, fgets — get a string from a stream 

SYNOPSIS 

#include <stdio.h> 

char 'gets (s) 
char *s; 

char *fgets (s, i:, stream) 
char «s; 
int n; 

FILE *stream; 

DESCRIPTION 

Gets reads characters from the standard input stream, stdin, into the array 
pointed to by 5 , until a new-line character is read or an end-of-file condition is 
encountered. The new-line character is discarded and the string is terminated 
with a null character. 

Fgets reads characters from the stream into the array pointed to by 5 , until 
n— 1 characters are read, or a new-line character is read and transferred to s , 
or an end-of-file condition is encountered. The string is then terminated with a 
null character. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S). 

DIAGNOSTICS 

If end-of-file is encountered and no characters have been read, no characters 
are transferred to s and a NULL pointer is returned. If a read error occurs, 
such as trying to use these functions on a file that has not been opened for 
reading, a NULL pointer is returned. Otherwise s is returned. 
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NAME 

getutent, getutid, getutline, pututline, setutent, endutent, utmpname - access 
utmp file entry 

SYNOPSIS 

#include <utmp.h> 

struct utmp 'getutent ( ) 

struct utmp 'getutid (id) 
struct utmp 'id; 

struct utmp 'getutline (line) 
struct utmp 'line; 

void pututline (utmp) 
struct utmp *utmp; 

void setutent ( ) 
void endutent ( ) 

void utmpname (file) 
char 'file; 

DESCRIPTION 


Getutent, getutid and getutline each return a pointer to a structure of the fol- 

lowing type: 



struct utmp { 



char 

ut_user[8]; 

/• User login name */ 

char 

ut_id[4]; 

/» /etc/inittab id (usually line #) »/ 

char 

ut_line[12]; 

/» device name (console, lnxx) */ 

short 

ut_pid; 

/* process id */ 

short 

ut_type; 

/* type of entry */ 

struct 

exit_status { 


short 

etermination; 

/• Process termination status »/ 

short 

eexit; 

/» Process exit status */ 

) ut_exit; 


/» The exit status of a process 



* marked as DEAD PROCESS. »/ 

time_t 

uttime; 

/* time entry was made »/ 


}; 

Getutent reads in the next entry from a utmp- like file. If the file is not already 
open, it opens it. If it reaches the end of the file, it fails. 


Getutid searches forward from the current point in the utmp file until it finds 
an entry with a utjype matching id — > utjype if the type specified is 
RUNLVL, BOOT TIME, OLD TIME or NEW TIME. If the type specified in id 
is INIT PROCESS, LOGINPROCESS, USER PROCESS or DEADPROCESS, 
then getutid will return a pointer to the first entry whose type is one of these 
four and whose utid field matches id—>ut_id. If the end of file is reached 
without a match, it fails. 

Getutline searches forward from the current point in the utmp file until it finds 
an entry of the type LOGIN PROCESS or USER PROCESS which also has a 
ut line string matching the line — >ut line string. If the end of file is reached 
without a match, it fails. 

Pututline writes out the supplied utmp structure into the utmp file. It uses 
getutid to search forward for the proper place if it finds that it is not already at 
the proper place. It is expected that normally the user of pututline will have 
searched for the proper entry using one of the getut routines. If so, pututline 
will not search. If pututline does not find a matching slot for the new entry, it 
will add a new entry to the end of the file. 
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Setutent resets the input stream to the beginning of the file. This should be 
done before each search for a new entry if it is desired that the entire file be 
examined. 

Endutent closes the currently open file. 

Utmpname allows the user to change the name of the file examined, from 
/etc/utmp to any other file. It is most often expected that this other file will be 
/etc/wtmp. If the file does not exist, this will not be apparent until the first 
attempt to reference the file is made. Utmpname does not open the file. It just 
closes the old file if it is currently open and saves the new file name. 

FILES 

/etc/utmp 

/etc/wtmp 

SEE ALSO 

ttyslot(3C), utmp(4). 

DIAGNOSTICS 

A NULL pointer is returned upon failure to read, whether for permissions or 
having reached the end of file, or upon failure to write. 

COMMENTS 

The most current entry is saved in a static structure. Multiple accesses require 
that it be copied before further accesses are made. Each call to either getutid 
or getutline sees the routine examine the static structure before performing 
more I/O. If the contents of the static structure match what it is searching for, 
it looks no further. For this reason to use getutline to search for multiple 
occurrences, it would be necessary to zero out the static after each success, or 
getutline would just return the same pointer over and over again. There is one 
exception to the rule about removing the structure before further reads are 
done. The implicit read done by pututline (if it finds that it is not already at 
the correct place in the file) will not hurt the contents of the static structure 
returned by the getutent, getutid or getutline routines, if the user has just 
modified those contents and passed the pointer back to pututline. 

These routines use buffered standard I/O for input, but pututline uses an 
unbuffered non-standard write to avoid race conditions between processes trying 
to modify the utmp and wtmp files. 
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NAME 

hsearch, hcreate, hdestroy — manage hash search tables 

SYNOPSIS 

#include <search.h> 

ENTRY 'hsearch (item, action) 

ENTRY item; 

ACTION action; 

int hcreate (nel) 
unsigned nel; 

void hdestroy ( ) 

DESCRIPTION 

Hsearch is a hash-table search routine generalized from Knuth (6.4) Algorithm 
D. It returns a pointer into a hash table indicating the location at which an 
entry can be found. Item is a structure of type ENTRY (defined in the 
<search.h> header file) containing two pointers: item. key points to the com- 
parison key, and item. data points to any other data to be associated with that 
key. (Pointers to types other than character should be cast to pointer-to- 
character.) Action is a member of an enumeration type ACTION indicating the 
disposition of the entry if it cannot be found in the table. ENTER indicates that 
the item should be inserted in the table at an appropriate point. FIND indicates 
that no entry should be made. Unsuccessful resolution is indicated by the 
return of a NULL pointer. 

Hcreate allocates sufficient space for the table, and must be called before 
hsearch is used. Nel is an estimate of the maximum number of entries that 
the table will contain. This number may be adjusted upward by the algorithm 
in order to obtain certain mathematically favorable circumstances. 

Hdestroy destroys the search table, and may be followed by another call to 
hcreate. 

NOTES 

Hsearch uses open addressing with a multiplicative hash function. However, 
its source code has many other options available which the user may select by 
compiling the hsearch source with the following symbols defined to the prepro- 
cessor: 

DIV Use the remainder modulo table size as the hash function 

instead of the multiplicative algorithm. 

USCR Use a User Supplied Comparison Routine for ascertaining 
table membership. The routine should be named hcompar 
and should behave in a mannner similar to strcmp (see 
string(lC)) . 

CHAINED Use a linked list to resolve collisions. If this option is 
selected, the following other options become available. 

START Place new entries at the beginning of the 

linked list (default is at the end) . 

SORTUP Keep the linked list sorted by key in ascend- 
ing order. 

SORTDOWN Keep the linked list sorted by key in des- 
cending order. 

Additionally, there are preprocessor flags for obtaining debugging printout 
(— DDEBUG) and for including a test driver in the calling routine 
(— DDRIVER). The source code should be consulted for further details. 
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EXAMPLE 

The following example will read in strings followed by two numbers and store 
them in a hash table, discarding duplicates. It will then read in strings and 
find the matching entry in the hash table and print it out. 

#include <stdio.h> 

#include <search.h> 

struct info { /* this is the info stored in the table */ 

int age, room; /* other than the key. */ 

); 

#define NUMEMPL 5000 /* # of elements in search table »/ 

main( ) 

f 

/» space to store strings */ 
char string_space[NUM_EMPL*20]; 

/* space to store employee info */ 
struct info info_space[NUM_EMPL]; 

/» next avail space in string_space */ 
char *str_ptr = string space; 

/» next avail space in info_space »/ 
struct info *info_ptr = info_space; 

ENTRY item, ‘found jtem, »hsearch( ); 

/• name to look for in table »/ 
char name_to_find[30]; 
int i = 0; 

/» create table */ 

(void) hcreate(NUMEMPL); 

while (scanf("%s%d%d", str_ptr, &info_ptr— >age, 

&info_ptr— > room) != EOF && i++ < NUM EMPL) { 

/* put info in structure, and structure in item »/ 

item. key = str_ptr; 

item.data = (char »)info_ptr; 

str_ptr += strlen(str_ptr) + 1; 

info_ptr++; 

/* put item into table »/ 

(void) hsearch(item, ENTER); 

} 


/» access table »/ 

item. key = name_to_find; 

while (scanf("%s", item. key) != EOF) { 

if ((founditem = hsearch(item, FIND)) != NULL) { 

/• if item is in the table »/ 

(void)printf(’Tound %s, age = %d, room = %d\n", 
founditem— > key, 

((struct info *)found_item— > data)— > age, 
((struct info *) found item— > data) — > room); 

} else { 

(void)printf(”no such employee %s\n", 
name to find) 
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SEE ALSO 

bsearch(3C), lsearch(3C), malloc(3C), malloc(3X), string(3C), tsearch(3C). 
DIAGNOSTICS 

Hsearch returns a NULL pointer if either the action is FIND and the item could 
not be found or the action is ENTER and the table is full. 

Hcreate returns zero if it cannot allocate sufficient space for the table. 

WARNING 

Hsearch and hcreate use malloci 3C) to allocate space. 

BUGS 

Only one hash search table may be active at any given time. 
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NAME 

13tol, ltol3 — convert between 3-byte integers and long integers 

SYNOPSIS 

void l3tol (Ip, cp, n) 
long »Ip; 
char «cp; 
int n; 

void lto!3 (cp, Ip, n) 
char «cp; 
long *lp; 
int n; 

DESCRIPTION 

Litol converts a list of n three-byte integers packed into a character string 
pointed to by cp into a list of long integers pointed to by Ip. 

Ltol3 performs the reverse conversion from long integers ( Ip ) to three-byte 
integers (cp). 

These functions are useful for file-system maintenance where the block 
numbers are three bytes long. 

SEE ALSO 

fs (4) . 

BUGS 

Because of possible differences in byte ordering, the numerical values of the 
long integers are machine-dependent. 
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NAME 

lsearch, lfind — linear search and update 

SYNOPSIS 

#include <stdio.h> 

#include <search.h> 

char »Isearch ((char *)key, (char *)base, nelp, sizeof(*key), compar) 
unsigned *nelp; 
int (*compar)( ); 

char * lfind ((char *)key, (char *)base, nelp, sizeof(*key), compar) 
unsigned *nelp; 
int (*compar)( ); 

DESCRIPTION 

Lsearch is a linear search routine generalized from Knuth (6.1) Algorithm S. 
It returns a pointer into a table indicating where a datum may be found. If the 
datum does not occur, it is added at the end of the table. Key points to the 
datum to be sought in the table. Base points to the first element in the table. 
Nelp points to an integer containing the current number of elements in the 
table. The integer is incremented if the datum is added to the table. Compar 
is the name of the comparison function which the user must supply ( strcmp , for 
example). It is called with two arguments that point to the elements being 
compared. The function must return zero if the elements are equal and non- 
zero otherwise. 

Lfind is the same as lsearch except that if the datum is not found, it is not 
added to the table. Instead, a NULL pointer is returned. 

NOTES 

The pointers to the key and the element at the base of the table should be of 
type pointer-to-element, and cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be 
cast into type pointer-to-element. 

EXAMPLE 

This fragment will read in < TABSIZE strings of length < ELSIZE and store 
them in a table, eliminating duplicates. 

#include <stdio.h> 

#include < search. h> 

#define TABSIZE 50 
#define ELSIZE 120 

char linetELSIZE], tab[TABSIZE][ ELSIZE], *lsearch( ); 
unsigned nel = 0; 
int strcmp( ); 

while (fgetsOine, ELSIZE, stdin) != NULL && 
nel < TABSIZE) 

(void) lsearch (line, (char »)tab, &nel, 

ELSIZE, strcmp); 


SEE ALSO 

bsearch(3C), hsearch(3C), tsearch(3C). 
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DIAGNOSTICS 

If the searched for datum is found, both Isearch and Ifind return a pointer to 
it. Otherwise, Ifind returns NULL and Isearch returns a pointer to the newly 
added element. 

BUGS 

Undefined results can occur if there is not enough room in the table to add a 
new item. 
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NAME 

malloc, free, realloc, calloc - main memory allocator 

SYNOPSIS 

char ♦malloc (size) 
unsigned size; 

void free (ptr) 
char *ptr; 

char *realloc (ptr, size) 
char *ptr; 
unsigned size; 

char *031100 (nelem, elsize) 
unsigned nelem, elsize; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package. 
Malloc returns a pointer to a block of at least size bytes suitably aligned for 
any use. 

The argument to free is a pointer to a block previously allocated by malloc, 
after free is performed this space is made available for further allocation, but 
its contents are left undisturbed. 

Undefined results will occur if the space assigned by malloc is overrun or if 
some random number is handed to free. 

Malloc allocates the first big enough contiguous reach of free space found in a 
circular search from the last block allocated or freed, coalescing adjacent free 
blocks as it searches. It calls sbrk (see brH 2)) to get more memory from the 
system when there is no suitable space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and 
returns a pointer to the (possibly moved) block. The contents will be 
unchanged up to the lesser of the new and old sizes. If no free block of size 
bytes is available in the storage arena, then realloc will ask malloc to enlarge 
the arena by size bytes and will then move the data to the new space. 

Realloc also works if ptr points to a block freed since the last call of malloc , 
realloc, or calloc, thus sequences of free, malloc and realloc can exploit the 
search strategy of malloc to do storage compaction. 

Calloc allocates space for an array of nelem elements of size elsize. The space 
is initialized to zeros. 

Each of the allocation routines returns a pointer to space suitably aligned (after 
possible pointer coercion) for storage of any type of object. 

SEE ALSO 

brk(2), malloc (3X). 

DIAGNOSTICS 

Malloc, realloc and calloc return a NULL pointer if there is no available 
memory or if the arena has been detectably corrupted by storing outside the 
bounds of a block. When this happens the block pointed to by ptr may be des- 
troyed. 

NOTE 

Search time increases when many objects have been allocated; that is, if a pro- 
gram allocates but never frees, then each successive allocation takes longer. 
For an alternate, more flexible implementation, see malloc OX). 
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NAME 

memccpy, memchr, memcmp, memcpy, memset - memory operations 
SYNOPSIS 

#include < memory. h> 

char *memccpy (si, s2, c, n) 
char »sl, *s2; 
int c, n; 

char ‘memchr (s, c, n) 
char »s; 
int c, n; 

int memcmp (si, s2, n) 
char »sl, »s2; 
int n; 

char ‘memcpy (si, s2, n) 
char »sl, »s2; 
int n; 

char ‘memset (s, c, n) 
char ‘s; 
int c, n; 

DESCRIPTION 

These functions operate as efficiently as possible on memory areas (arrays of 
characters bounded by a count, not terminated by a null character). They do 
not check for the overflow of any receiving memory area. 

Memccpy copies characters from memory area s2 into si, stopping after the 
first occurrence of character c has been copied, or after n characters have been 
copied, whichever comes first. It returns a pointer to the character after the 
copy of c in si, or a NULL pointer if c was not found in the first n characters 
of s2. 

Memchr returns a pointer to the first occurrence of character c in the first n 
characters of memory area s, or a NULL pointer if c does not occur. 

Memcmp compares its arguments, looking at the first n characters only, and 
returns an integer less than, equal to, or greater than 0, according as si is lexi- 
cographically less than, equal to, or greater than s2. 

Memcpy copies n characters from memory area s2 to si. It returns si. 

Memset sets the first n characters in memory area s to the value of character 
c. It returns s. 

NOTE 

For user convenience, all these functions are declared in the optional 
< memory. h> header file. 

BUGS 

Memcmp uses native character comparison, which is signed on PDP-lls and 
VAX- 11s, unsigned on other machines. Thus the sign of the value returned 
when one of the characters has its high-order bit set is implementation- 
dependent. 

Character movement is performed differently in different implementations. 
Thus overlapping moves may yield surprises. 
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NAME 

mktemp — make a unique file name 
SYNOPSIS 

char *mktemp (template) 
char ‘template; 

DESCRIPTION 

Mktemp replaces the contents of the string pointed to by template by a unique 
file name, and returns the address of template. The string in template should 
look like a file name with six trailing Xs; mktemp will replace the Xs with a 
letter and the current process ID. The letter will be chosen so that the resulting 
name does not duplicate an existing file. 


SEE ALSO 

getpid(2), tmpfile(3S), tmpnam(3S). 

BUGS 

It is possible to run out of letters. 
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NAME 

monitor — prepare execution profile 
SYNOPSIS 

#include <mon.h> 

void monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int (*lowpc)( ), (*highpc) ( ); 

WORD ‘buffer; 
int bufsize, nfunc; 

DESCRIPTION 

An executable program created by cc -p automatically includes calls for mon- 
itor with default parameters; monitor needn’t be called explicitly except to gain 
fine control over profiling. 

Monitor is an interface to profiK 2). Lowpc and highpc are the addresses of 
two functions; buffer is the address of a (user supplied) array of bufsize 
WORDs (defined in the <mon.h> header file). Monitor arranges to record a 
histogram of periodically sampled values of the program counter, and of counts 
of calls of certain functions, in the buffer. The lowest address sampled is that 
of lowpc and the highest is just below highpc. Lowpc may not equal 0 for this 
use of monitor. At most nfunc call counts can be kept; only calls of functions 
compiled with the profiling option -p of cc(l) are recorded. (Except on the 
PDP-11, the C Library and Math Library supplied when cc -p is used also 
have call counts recorded.) 

For the results to be significant, especially where there are small, heavily used 
routines, it is suggested that the buffer be no more than a few times smaller 
than the range of locations sampled. 

To profile the entire program, it is sufficient to use 
extern etext; 

monitor ((int (»)())2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text; see end( 3C). 

To stop execution monitoring and write the results on the file mon.out, use 
monitor ((int (»)())0, 0, 0, 0, 0); 

Prof{ 1) can then be used to examine the results. 

FILES 

mon.out 

/lib/libp/libc.a 

/lib/libp/libm.a 

SEE ALSO 

profil (2) , end(3C). 

cc(l), prof(l) in the UNIX System V User Reference Manual. 
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NAME 

nlist — get entries from name list 

SYNOPSIS 

#include < nlist. h> 

int nlist (file-name, nl) 
char ‘file-name; 
struct nlist *nl; 

DESCRIPTION 

Nlist examines the name list in the executable file whose name is pointed to by 
file-name, and selectively extracts a list of values and puts them in the array of 
nlist structures pointed to by nl. The name list nl consists of an array of struc- 
tures containing names of variables, types and values. The list is terminated 
with a null name; that is, a null string is in the name position of the structure. 
Each variable name is looked up in the name list of the file. If the name is 
found, the type and value of the name are inserted in the next two fields. The 
type field will be set to 0 unless the file was compiled with the -g option. If 
the name is not found, both entries are set to 0. See a.outi 4) for a discussion 
of the symbol table structure. 

This function is useful for examining the system name list kept in the file 
/unix. In this way programs can obtain system addresses that are up to date. 

NOTES 

The <nlist.h> header file is automatically included by <a.out.h> for compa- 
tability. However, if the only information needed from <a.out.h> is for use of 
nlist, then including <a.out.h> is discouraged. If <a.out.h> is included, the 
line “#undef n name” may need to follow it. 

SEE ALSO 

a.out(4). 

DIAGNOSTICS 

All value entries are set to 0 if the file cannot be read or if it does not contain a 
valid name list. 

Nlist returns —1 upon error; otherwise it returns 0. 
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NAME 

perror, errno, sys_errlist, sys_nerr - system error messages 
SYNOPSIS 

void perror (s) 
char »s; 

extern int errno; 
extern char »sys_errlist[ 1; 
extern int sys_nerr; 

DESCRIPTION 

Perror produces a message on the standard error output, describing the last 
error encountered during a call to a system or library function. The argument 
string s is printed first, then a colon and a blank, then the message and a new- 
line. To be of most use, the argument string should include the name of the 
program that incurred the error. The error number is taken from the external 
variable errno, which is set when errors occur but not cleared when non- 
erroneous calls are made. 

To simplify variant formatting of messages, the array of message strings 
syserrlist is provided; errno can be used as an index in this table to get the 
message string without the new-line. Sysnerr is the largest message number 
provided for in the table; it should be checked because new error codes may be 
added to the system before they are added to the table. 

SEE ALSO 

intro (2). 
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NAME 

popen, pclose — initiate pipe to/from a process 

SYNOPSIS 

#include <stdio.h> 

FILE • popen (command, type) 
char ‘command, ‘type; 

int pclose (stream) 

FILE ‘stream; 

DESCRIPTION 

The arguments to popen are pointers to null-terminated strings containing, 
respectively, a shell command line and an I/O mode, either r for reading or w 
for writing. Popen creates a pipe between the calling program and the com- 
mand to be executed. The value returned is a stream pointer such that one can 
write to the standard input of the command, if the I/O mode is w, by writing to 
the file stream; and one can read from the standard output of the command, if 
the I/O mode is r, by reading from the file stream. 

A stream opened by popen should be closed by pclose, which waits for the 
associated process to terminate and returns the exit status of the command. 

Because open files are shared, a type r command may be used as an input filter 
and a type w as an output filter. 

SEE ALSO 

pipe (2), wait(2), fclose(3S), fopen(3S), system(3S). 

DIAGNOSTICS 

Popen returns a NULL pointer if files or processes cannot be created, or if the 
shell cannot be accessed. 

Pclose returns —1 if stream is not associated with a “popened" command. 

BUGS 

If the original and “ popened ” processes concurrently read or write a common 
file, neither should use buffered I/O, because the buffering gets all mixed up. 
Problems with an output filter may be forestalled by careful buffer flushing, e.g. 
with /flush; see /close (3S). 
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NAME 

printf, fprintf, sprintf - print formatted output 
SYNOPSIS 

#include <stdio.h> 

int printf (format [ , arg ] . . . ) 

char ‘format; 

int fprintf (stream, format [ , arg ] ... ) 

FILE ‘stream; 
char ‘format; 

int sprintf (s, format [ , arg ] ... ) 

char «s, format; 

DESCRIPTION 

Printf places output on the standard output stream stdout. Fprintf places out- 
put on the named output stream. Sprintf places “output,” followed by the null 
character (\0), in consecutive bytes starting at *j; it is the user’s responsibility 
to ensure that enough storage is available. Each function returns the number 
of characters transmitted (not including the \0 in the case of sprintf ), or a 
negative value if an output error was encountered. 

Each of these functions converts, formats, and prints its args under control of 
the format. The format is a character string that contains two types of 
objects: plain characters, which are simply copied to the output stream, and 
conversion specifications, each of which results in fetching of zero or more args. 
The results are undefined if there are insufficient args for the format. If the 
format is exhausted while args remain, the excess args are simply ignored. 

Each conversion specification is introduced by the character %. After the %, 
the following appear in sequence: 

Zero or more flags, which modify the meaning of the conversion 
specification. 

An optional decimal digit string specifying a minimum field width. If 
the converted value has fewer characters than the field width, it will be 
padded on the left (or right, if the left-adjustment flag described 
below, has been given) to the field width. If the field width for an s 
conversion is preceded by a 0, the string is right adjusted with zero- 
padding on the left. 

A precision that gives the minimum number of digits to appear for the 
d, o, u, x, or X conversions, the number of digits to appear after the 
decimal point for the e and f conversions, the maximum number of 
significant digits for the g conversion, or the maximum number of 
characters to be printed from a string in s conversion. The precision 
takes the form of a period (.) followed by a decimal digit string; a null 
digit string is treated as zero. 

An optional I (ell) specifying that a following d, o, u, x, or X conver- 
sion character applies to a long integer arg. A 1 before any other 
conversion character is ignored. 

A character that indicates the type of conversion to be applied. 

A field width or precision may be indicated by an asterisk (•) instead of a digit 
string. In this case, an integer arg supplies the field width or precision. The 
arg that is actually converted is not fetched until the conversion letter is seen, 
so the args specifying field width or precision must appear before the arg (if 
any) to be converted. 
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The flag characters and their meanings are: 

- The result of the conversion will be left-justified within the field. 

+ The result of a signed conversion will always begin with a sign ( + 

or -). 

blank If the first character of a signed conversion is not a sign, a blank 
will be prefixed to the result. This implies that if the blank and + 
flags both appear, the blank flag will be ignored. 

# This flag specifies that the value is to be converted to an “alternate 

form.” For c, d, s, and u conversions, the flag has no effect. For o 
conversion, it increases the precision to force the first digit of the 
result to be a zero. For x or X conversion, a non-zero result will 
have Ox or OX prefixed to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no digits follow 
the point (normally, a decimal point appears in the result of these 
conversions only if a digit follows it). For g and G conversions, 
trailing zeroes will not be removed from the result (which they nor- 
mally are). 

The conversion characters and their meanings are: 

d, o,u,x,x The integer arg is converted to signed decimal, unsigned octal, 

decimal, or hexadecimal notation (x and X), respectively; the letters 
abcdef are used for x conversion and the letters ABCDEF for X 
conversion. The precision specifies the minimum number of digits 
to appear; if the value being converted can be represented in fewer 
digits, it will be expanded with leading zeroes. (For compatibility 
with older versions, padding with leading zeroes may alternatively 
be specified by prepending a zero to the field width. This does not 
imply an octal value for the field width.) The default precision is 1. 
The result of converting a zero value with a precision of zero is a 
null string. 

f The float or double arg is converted to decimal notation in the style 

“[ -jddd.ddd,” where the number of digits after the decimal point 
is equal to the precision specification. If the precision is missing, six 
digits are output; if the precision is explicitly 0, no decimal point 
appears. 

e, E The float or double arg is converted in the style “[ -]d.ddde±dd,” 

where there is one digit before the decimal point and the number of 
digits after it is equal to the precision; when the precision is miss- 
ing, six digits are produced; if the precision is zero, no decimal point 
appears. The E format code will produce a number with E instead 
of e introducing the exponent. The exponent always contains at 
least two digits. 

g,G The float or double arg is printed in style f or e (or in style E in the 

case of a G format code) , with the precision specifying the number 
of significant digits. The style used depends on the value converted: 
style e will be used only if the exponent resulting from the conver- 
sion is less than —4 or greater than the precision. Trailing zeroes 
are removed from the result; a decimal point appears only if it is 
followed by a digit. 

c The character arg is printed. 

s The arg is taken to be a string (character pointer) and characters 

from the string are printed until a null character (\0) is encoun- 
tered or the number of characters indicated by the precision 
specification is reached. If the precision is missing, it is taken to be 
infinite, so all characters up to the first null character are printed. 
A NULL value for arg will yield undefined results. 
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% Print a %; no argument is converted. 

In no case does a non-existent or small field width cause truncation of a field; if 
the result of a conversion is wider than the field width, the field is simply 
expanded to contain the conversion result. Characters generated by print f and 
fprintf are printed as if putcOS ) had been called. 

EXAMPLES 

To print a date and time in the form “Sunday, July 3, 10:02,” where weekday 
and month are pointers to null-terminated strings: 

printf("%s, %s %d, %d:%.2d", weekday, month, day, hour, min); 

To print it to 5 decimal places: 

printf ("pi = %.5f, 4 * atan(l.O)); 

SEE ALSO 

ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 

putc, putchar, fputc, putw — put character or word on a stream 

SYNOPSIS 

#include <stdio.h> 

int putc (c, stream) 
int c; 

FILE ‘stream; 

int putchar (c) 
int c; 

int fputc (c, stream) 
int c; 

FILE ‘stream; 

int putw (w, stream) 
int w; 

FILE ‘stream; 

DESCRIPTION 

Putc writes the character c onto the output stream (at the position where the 
file pointer, if defined, is pointing). Putchar (c) is defined as putc(c, stdout) . 
Putc and putchar are macros. 

Fputc behaves like putc, but is a function rather than a macro. Fputc runs 
more slowly than putc, but it takes less space per invocation and its name can 
be passed as an argument to a function. 

Putw writes the word (i.e. integer) w to the output stream (at the position at 
which the file pointer, if defined, is pointing). The size of a word is the size of 
an integer and varies from machine to machine. Putw neither assumes nor 
causes special alignment in the file. 

Output streams, with the exception of the standard error stream stderr, are by 
default buffered if the output refers to a file and line-buffered if the output 
refers to a terminal. The standard error output stream stderr is by default 
unbuffered, but use of freopen (see fopen{ 3S)) will cause it to become buffered 
or line-buffered. When an output stream is unbuffered, information is queued 
for writing on the destination file or terminal as soon as written; when it is 
buffered, many characters are saved up and written as a block. When it is 
line-buffered, each line of output is queued for writing on the destination termi- 
nal as soon as the line is completed (that is, as soon as a new-line character is 
written or terminal input is requested). SetbufO S) or SetbufO S) may be used 
to change the stream’s buffering strategy. 

SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), fread(3S), printf(3S), puts(3S), setbuf(3S). 
DIAGNOSTICS 

On success, these functions each return the value they have written. On 
failure, they return the constant EOF. This will occur if the file stream is not 
open for writing or if the output file cannot be grown. Because EOF is a valid 
integer, /error (3S) should be used to detect putw errors. 

BUGS 

Because it is implemented as a macro, putc treats incorrectly a stream argu- 
ment with side effects. In particular, putc(c, *f++); doesn’t work sensibly. 
Fputc should be used instead. 

Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent, and may not be read using getw on a 
different processor. 
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NAME 

putenv — change or add value to environment 

SYNOPSIS 

int putenv (string) 
char ‘string; 

DESCRIPTION 

String points to a string of the form “name = value.” Putenv makes the value 
of the environment variable name equal to value by altering an existing vari- 
able or creating a new one. In either case, the string pointed to by string 
becomes part of the environment, so altering the string will change the environ- 
ment. The space used by string is no longer used once a new string-defining 
name is passed to putenv. 

DIAGNOSTICS 

Putenv returns non-zero if it was unable to obtain enough space via malloc for 
an expanded environment, otherwise zero. 

SEE ALSO 

exec(2), getenv(3C), malloc(3C), environ(5). 

WARNINGS 

Putenv manipulates the environment pointed to by environ, and can be used in 
conjunction with getenv. However, envp (the third argument to main) is not 
changed. 

This routine uses malloc (.30 to enlarge the environment. 

After putenv is called, environmental variables are not in alphabetical order. 

A potential error is to call putenv with an automatic variable as the argument, 
then exit the calling function while string is still part of the environment. 
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NAME 

putpwent — write password file entry 

SYNOPSIS 

#include <pwd.h> 

int putpwent (p, f) 
struct passwd »p; 

FILE «f; 

DESCRIPTION 

Putpwent is the inverse of getpwenti 3C). Given a pointer to a passwd struc- 
ture created by getpwent (or getpwuid or getpwnam ), putpwent writes a line on 
the stream /, which matches the format of /etc/passwd. 

DIAGNOSTICS 

Putpwent returns non-zero if an error was detected during its operation, other- 
wise zero. 

SEE ALSO 

getpwent(3C). 

WARNING 

The above routine uses <stdio.h>, which causes it to increase the size of pro- 
grams, not otherwise using standard I/O, more than might be expected. 
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NAME 

puts, fputs — put a string on a stream 

SYNOPSIS 

#include <stdio.h> 

int puts (s) 
char *s; 

int fputs (s, stream) 
char *s; 

FILE *stream; 

DESCRIPTION 

Puts writes the null-terminated string pointed to by s, followed by a new-line 
character, to the standard output stream stdout. 

Fputs writes the null-terminated string pointed to by i to the named output 
stream . 

Neither function writes the terminating null character. 

DIAGNOSTICS 

Both routines return EOF on error. This will happen if the routines try to write 
on a file that has not been opened for writing. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), printf(3S), putc(3S). 

NOTES 

Puts appends a new-line character while fputs does not. 


- 1 - 



QSORT (3C) 


QSORTC3C) 


NAME 

qsort — quicker sort 
SYNOPSIS 

void qsort ((char •) base, nel, sizeof (*base), compar) 

unsigned nel; 

int (‘compar) ( ); 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. It sorts a table of 
data in place. 

Base points to the element at the base of the table. Nel is the number of ele- 
ments in the table. Compar is the name of the comparison function, which is 
called with two arguments that point to the elements being compared. As the 
function must return an integer less than, equal to, or greater than zero, so 
must the first argument to be considered be less than, equal to, or greater than 
the second. 

NOTES 

The pointer to the base of the table should be of type pointer-to-element, and 
cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 

The order in the output of two items which compare as equal is unpredictable. 

SEE ALSO 

bsearch(3C), lsearch(3C), string(3C). 

sort(l) in the UNIX System V User Reference Manual. 
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NAME 

rand, srand — simple random-number generator 

SYNOPSIS 

int rand ( ) 

void srand (seed) 
unsigned seed; 

DESCRIPTION 

Rand uses a multiplicative congruential random-number generator with period 
2 that returns successive pseudo-random numbers in the range from 0 to 
2 - 1 . 

Srand can be called at any time to reset the random-number generator to a 
random starting point. The generator is initially seeded with a value of 1 . 

NOTE 

The spectral properties of rand leave a great deal to be desired. Drand48( 3C) 
provides a much better, though more elaborate, random-number generator. 

SEE ALSO 

drand48(3C). 
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NAME 

scanf, fscanf, sscanf — convert formatted input 

SYNOPSIS 

#include <stdio.h> 

int scanf (format [ , pointer ] ... ) 

char ‘format; 

int fscanf (stream, format [ , pointer ] ... ) 

FILE ‘stream; 
char ‘format; 

int sscanf (s, format t , pointer ] . . . ) 

char *s, ‘format; 

DESCRIPTION 

Scanf reads from the standard input stream stdin. Fscanf reads from the 
named input stream. Sscanf reads from the character string s. Each function 
reads characters, interprets them according to a format, and stores the results 
in its arguments. Each expects, as arguments, a control string format 
described below, and a set of pointer arguments indicating where the converted 
input should be stored. 

The control string usually contains conversion specifications, which are used to 
direct interpretation of input sequences. The control string may contain: 

1. White-space characters (blanks, tabs, new-lines, or form-feeds) which, 
except in two cases described below, cause input to be read up to the next 
non-white-space character. 

2. An ordinary character (not %), which must match the next character of 
the input stream. 

3. Conversion specifications, consisting of the character %, an optional assign- 
ment suppressing character », an optional numerical maximum field width, 
an optional 1 (ell) or h indicating the size of the receiving variable, and a 
conversion code. 

A conversion specification directs the conversion of the next input field; the 
result is placed in the variable pointed to by the corresponding argument, unless 
assignment suppression was indicated by *. The suppression of assignment pro- 
vides a way of describing an input field which is to be skipped. An input field 
is defined as a string of non-space characters; it extends to the next inappropri- 
ate character or until the field width, if specified, is exhausted. For all descrip- 
tors except “[” and “c”, white space leading an input field is ignored. 

The conversion code indicates the interpretation of the input field; the 
corresponding pointer argument must usually be of a restricted type. For a 
suppressed field, no pointer argument is given. The following conversion codes 
are legal: 

% a single % is expected in the input at this point; no assignment is done, 

d a decimal integer is expected; the corresponding argument should be an 

integer pointer. 

u an unsigned decimal integer is expected; the corresponding argument 

should be an unsigned integer pointer. 

o an octal integer is expected; the corresponding argument should be an 

integer pointer. 
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x a hexadecimal integer is expected; the corresponding argument should 
be an integer pointer. 

e,f,g a floating point number is expected; the next field is converted accord- 
ingly and stored through the corresponding argument, which should be 
a pointer to a float. The input format for floating point numbers is an 
optionally signed string of digits, possibly containing a decimal point, 
followed by an optional exponent field consisting of an E or an e, fol- 
lowed by an optional +, — , or space, followed by an integer, 
s a character string is expected; the corresponding argument should be a 

character pointer pointing to an array of characters large enough to 
accept the string and a terminating \0, which will be added automati- 
cally. The input field is terminated by a white-space character, 
c a character is expected; the corresponding argument should be a char- 
acter pointer. The normal skip over white space is suppressed in this 
case; to read the next non-space character, use % Is. If a field width is 
given, the corresponding argument should refer to a character array; 
the indicated number of characters is read. 

[ indicates string data and the normal skip over leading white space is 

suppressed. The left bracket is followed by a set of characters, which 
we will call the scanset, and a right bracket; the input field is the max- 
imal sequence of input characters consisting entirely of characters in 
the scanset. The circumflex ("), when it appears as the first character 
in the scanset, serves as a complement operator and redefines the scan- 
set as the set of all characters not contained in the remainder of the 
scanset string. There are some conventions used in the construction of 
the scanset. A range of characters may be represented by the con- 
struct first- last, thus [0123456789] may be expressed [0-9], Using 
this convention, first must be lexically less than or equal to last, or else 
the dash will stand for itself. The dash will also stand for itself when- 
ever it is the first or the last character in the scanset. To include the 
right square bracket as an element of the scanset, it must appear as the 
first character (possibly preceded by a circumflex) of the scanset, and 
in this case it will not be syntactically interpreted as the closing 
bracket. The corresponding argument must point to a character array 
large enough to hold the data field and the terminating \0, which will 
be added automatically. At least one character must match for this 
conversion to be considered successful. 

The conversion characters d, u, o, and x may be preceded by 1 or h to indicate 
that a pointer to long or to short rather than to int is in the argument list. 
Similarly, the conversion characters e, f, and g may be preceded by 1 to indicate 
that a pointer to double rather than to float is in the argument list. The 1 or h 
modifier is ignored for other conversion characters. 

Scan f conversion terminates at EOF, at the end of the control string, or when 
an input character conflicts with the control string. In the latter case, the 
offending character is left unread in the input stream. 

Scan/ returns the number of successfully matched and assigned input items; 
this number can be zero in the event of an early conflict between an input char- 
acter and the control string. If the input ends before the first conflict or 
conversion, EOF is returned. 
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EXAMPLES 

The call: 

int i, n; float x; char name[50]; 
n = scanf ("%d%f%s", &i, &x, name); 

with the input line: 

25 54.32E-1 thompson 

will assign to n the value 3, to i the value 25, to x the value 5.432, and name 
will contain thompson\0. Or: 

int i; float x; char name[50l; 

(void) scanf ("%2d%f%*d %[0-9l", &i, &x, name); 

with input: 

56789 0123 56a72 

will assign 56 to i, 789.0 to x, skip 0123, and place the string 56\0 in name. 
The next call to getchar (see getc( 3S)) will return a. 

SEE ALSO 

getc(3S), printf(3S), strtod(3C), strtol(3C). 

NOTE 

Trailing white space (including a new-line) is left unread unless matched in the 
control string. 

DIAGNOSTICS 

These functions return EOF on end of input and a short count for missing or 
illegal data items. 

BUGS 

The success of literal matches and suppressed assignments is not directly deter- 
minable. 
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NAME 

setbuf, setvbuf — assign buffering to a stream 
SYNOPSIS 

#include <stdio.h> 

void setbuf (stream, buf) 

FILE ‘stream; 
char ‘buf; 

int setvbuf (stream, buf, type, size) 

FILE ‘stream; 
char »buf; 
int type, size; 

DESCRIPTION 

Setbuf may be used after a stream has been opened but before it is read or 
written. It causes the array pointed to by buf to be used instead of an 
automatically allocated buffer. If buf is the NULL pointer input/output will be 
completely unbuffered. 

A constant BUFSIZ, defined in the <stdio.h> header file, tells how big an 
array is needed: 

char buftBUFSIZ]; 

Setvbuf may be used after a stream has been opened but before it is read or 
written. Type determines how stream will be buffered. Legal values for type 
(defined in stdio.h) are: 

IOFBF causes input/output to be fully buffered. 

IOLBF causes output to be line buffered; the buffer will be flushed 

when a newline is written, the buffer is full, or input is 
requested. 

IONBF causes input/output to be completely unbuffered. 

If buf is not the NULL pointer, the array it points to will be used for buffering, 
instead of an automatically allocated buffer. Size specifies the size of the 
buffer to be used. The constant BUFSIZ in <stdio.h> is suggested as a good 
buffer size. If input/output is unbuffered, buf and size are ignored. 

By default, output to a terminal is line buffered and all other input/output is 
fully buffered. 

SEE ALSO 

fopen(3S), getc(3S), malloc(3C), putc(3S), stdio(3S). 

DIAGNOSTICS 

If an illegal value for type or size is provided, setvbuf returns a non-zero value. 
Otherwise, the value returned will be zero. 

NOTE 

A common source of error is allocating buffer space as an “automatic” variable 
in a code block, and then failing to close the stream in the same block. 
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NAME 

setjmp, longjmp — non-local goto 

SYNOPSIS 

#include <setjmp.h> 

int setjmp (env) 
jmp buf env; 

void longjmp (env, val) 
jmp buf env; 
int val; 

DESCRIPTION 

These functions are useful for dealing with errors and interrupts encountered in 
a low-level subroutine of a program. 

Setjmp saves its stack environment in env (whose type, jmp buf, is defined in 
the <setjmp.h> header file) for later use by longjmp. It returns the value 0. 

Longjmp restores the environment saved by the last call of setjmp with the 
corresponding env argument. After longjmp is completed, program execution 
continues as if the corresponding call of setjmp (which must not itself have 
returned in the interim) had just returned the value val. Longjmp cannot 
cause setjmp to return the value 0. If longjmp is invoked with a second argu- 
ment of 0, setjmp will return 1. All accessible data had values as of the time 
longjmp was called. 

SEE ALSO 

signal (2). 

WARNING 

If longjmp is called even though env was never primed by a call to setjmp, or 
when the last such call was in a function which has since returned, absolute 
chaos is guaranteed. 
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NAME 

sleep — suspend execution for interval 
SYNOPSIS 

unsigned sleep (seconds) 
unsigned seconds; 

DESCRIPTION 

The current process is suspended from execution for the number of seconds 
specified by the argument. The actual suspension time may be less than that 
requested for two reasons: (1) Because scheduled wakeups occur at fixed I- 
second intervals, (on the second, according to an internal clock) and (2) 
because any caught signal will terminate the sleep following execution of that 
signal’s catching routine. Also, the suspension time may be longer than 
requested by an arbitrary amount due to the scheduling of other activity in the 
system. The value returned by sleep will be the “unslept” amount (the 
requested time minus the time actually slept) in case the caller had an alarm 
set to go off earlier than the end of the requested sleep time, or premature 
arousal due to another caught signal. 

The routine is implemented by setting an alarm signal and pausing until it (or 
some other signal) occurs. The previous state of the alarm signal is saved and 
restored. The calling program may have set up an alarm signal before calling 
sleep. If the sleep time exceeds the time till such alarm signal, the process 
sleeps only until the alarm signal would have occurred. The caller’s alarm 
catch routine is executed just before the sleep routine returns. But if the sleep 
time is less than the time till such alarm, the prior alarm time is reset to go off 
at the same time it would have without the intervening sleep. 

SEE ALSO 

alarm (2), pause (2), signal (2). 
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NAME 

ssignal, gsignal - software signals 

SYNOPSIS 

#include <signal.h> 

int (*ssignal (sig, action) )( ) 
int sig, (‘action) ( ); 

int gsignal (sig) 
int sig; 

DESCRIPTION 

Ssignal and gsignal implement a software facility similar to signal (2). This 
facility is used by the Standard C Library to enable users to indicate the dispo- 
sition of error conditions, and is also made available to users for their own pur- 
poses. 

Software signals made available to users are associated with integers in the 
inclusive range 1 through 15. A call to ssignal associates a procedure, action, 
with the software signal sig ; the software signal, sig, is raised by a call to gsig- 
nal. Raising a software signal causes the action established for that signal to 
be taken. 

The first argument to ssignal is a number identifying the type of signal for 
which an action is to be established. The second argument defines the action; it 
is either the name of a (user-defined) action function or one of the manifest 
constants SIG_DFL (default) or SIGJGN (ignore). Ssignal returns the action 
previously established for that signal type; if no action has been established or 
the signal number is illegal, ssignal returns SIGDFL. 

Gsignal raises the signal identified by its argument, sig\ 

If an action function has been established for sig, then that action is reset 
to SIG DFL and the action function is entered with argument sig. Gsig- 
nal returns the value returned to it by the action function. 

If the action for sig is SIGJGN, gsignal returns the value 1 and takes no 
other action. 

If the action for sig is SIGJJFL, gsignal returns the value 0 and takes no 
other action. 

If sig has an illegal value or no action was ever specified for sig, gsignal 
returns the value 0 and takes no other action. 

SEE ALSO 

signal (2). 

NOTES 

There are some additional signals with numbers outside the range 1 through 15 
which are used by the Standard C Library to indicate error conditions. Thus, 
some signal numbers outside the range 1 through 15 are legal, although their 
use may interfere with the operation of the Standard C Library. 
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NAME 

stdio — standard buffered input/output package 

SYNOPSIS 

#include <stdio.h> 

FILE *stdin, *stdout, *stderr; 

DESCRIPTION 

The functions described in the entries of sub-class 3S of this manual constitute 
an efficient, user-level I/O buffering scheme. The in-line macros ge/c(3S) and 
putci 3S) handle characters quickly. The macros getchar and putchar, and the 
higher-level routines fgetc, /gets, /print/, /putc, /puts, /read, /scan/, /write, 
gets, getw, print/, puts, putw, and scan/ all use or act as if they use getc and 
putc; they can be freely intermixed. 

A file with associated buffering is called a stream and is declared to be a 
pointer to a defined type FILE. Fopen(, 3S) creates certain descriptive data for a 
stream and returns a pointer to designate the stream in all further transactions. 
Normally, there are three open streams with constant pointers declared in the 
<stdio.h> header file and associated with the standard open files: 

stdin standard input file 

stdout standard output file 

stderr standard error file 

A constant NULL (0) designates a nonexistent pointer. 

An integer-constant EOF (—1) is returned upon end-of-file or error by most 
integer functions that deal with streams (see the individual descriptions for 
details). 

An integer constant BUFSIZ specifies the size of the buffers used by the partic- 
ular implementation. 

Any program that uses this package must include the header file of pertinent 
macro definitions, as follows: 

#include < stdio. h> 

The functions and constants mentioned in the entries of sub-class 3S of this 
manual are declared in that header file and need no further declaration. The 
constants and the following “functions” are implemented as macros (redeclara- 
tion of these names is perilous): getc, getchar, putc, putchar, /error, /eo/, 
clearerr, and fileno. 

SEE ALSO 

open (2), close(2), lseek(2), pipe(2), read(2), write(2), ctermid(3S), 
cuserid(3S), fclose(3S), ferror(3S), fopen(3S), fread(3S), fseek(3S), getc(3S), 
gets(3S), popen(3S), printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), 
system(3S), tmpfile(3S), tmpnam(3S), ungetc(3S). 

DIAGNOSTICS 

Invalid stream pointers will usually cause grave disorder, possibly including 
program termination. Individual function descriptions describe the possible 
error conditions. 
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NAME 

ftok — standard interprocess communication package 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

key_t ftok(path, id) 
char *path; 
char id; 

DESCRIPTION 

All interprocess communication facilities require the user to supply a key to be 
used by the msggeti 2), semgeti 2), and shmgeti 2) system calls to obtain inter- 
process communication identifiers. One suggested method for forming a key is 
to use the ftok subroutine described below. Another way to compose keys is to 
include the project ID in the most significant byte and to use the remaining 
portion as a sequence number. There are many other ways to form keys, but it 
is necessary for each system to define standards for forming them. If some 
standard is not adhered to, it will be possible for unrelated processes to uninten- 
tionally interfere with each other’s operation. Therefore, it is strongly sug- 
gested that the most significant byte of a key in some sense refer to a project so 
that keys do not conflict across a given system. 

Ftok returns a key based on path and id that is usable in subsequent msgget, 
semget, and shmget system calls. Path must be the path name of an existing 
file that is accessible to the process. Id is a character which uniquely identifies 
a project. Note that ftok will return the same key for linked files when called 
with the same id and that it will return different keys when called with the 
same file name but different ids. 

SEE ALSO 

intro (2), msgget(2), semget(2), shmget(2). 

DIAGNOSTICS 

Ftok returns (key_t) -1 if path does not exist or if it is not accessible to the 
process. 

WARNING 

If the file whose path is passed to ftok is removed when keys still refer to the 
file, future calls to ftok with the same path and id will return an error. If the 
same file is recreated, then ftok is likely to return a different key than it did 
the original time it was called. 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, strrchr, strpbrk, 
strspn, strcspn, strtok — string operations 

SYNOPSIS 

#include <string.h> 

char ‘strcat (si, s2) 
char *sl, *s2; 

char *strncat (si, s2, n) 
char »sl, »s2; 
int n; 

int strcmp (si, s2) 
char *sl, »s2; 

int strncmp (si, s2, n) 
char »sl, »s2; 
int n; 

char *strcpy (si, s2) 
char »sl, *s2; 

char *strncpy (si, s2, n) 
char *sl, »s2; 
int n; 

int strlen (s) 
char *s; 

char ‘strchr (s, c) 
char *s; 
int c; 

char ‘strrchr (s, c) 
char »s; 
int c; 

char ‘strpbrk (si, s2) 
char *sl, *s2; 

int strspn (si, s2) 
char *sl, »s2; 

int strcspn (si, s2) 
char *sl, «s2; 

char ‘strtok (si, s2) 
char »sl, »s2; 

DESCRIPTION 

The arguments si, s2 and s point to strings (arrays of characters terminated by 
a null character). The functions strcat, strncat , strcpy , and strncpy all alter 
si. These functions do not check for overflow of the array pointed to by si. 

Strcat appends a copy of string s2 to the end of string si. Strncat appends at 
most n characters. Each returns a pointer to the null-terminated result. 

Strcmp compares its arguments and returns an integer less than, equal to, or 
greater than 0, according as si is lexicographically less than, equal to, or 
greater than s2. Strncmp makes the same comparison but looks at at most n 
characters. 
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Strcpy copies string s2 to si, stopping after the null character has been copied. 
Strncpy copies exactly n characters, truncating s2 or adding null characters to 
si if necessary. The result will not be null-terminated if the length of s2 is n 
or more. Each function returns si. 

Strlen returns the number of characters in s, not including the terminating null 
character. 

Strchr ( strrchr ) returns a pointer to the first (last) occurrence of character c in 
string s, or a NULL pointer if c does not occur in the string. The null charac- 
ter terminating a string is considered to be part of the string. 

Strpbrk returns a pointer to the first occurrence in string si of any character 
from string s2, or a NULL pointer if no character from s2 exists in si. 

Strspn ( strcspn ) returns the length of the initial segment of string si which 
consists entirely of characters from (not from) string s2. 

Strtok considers the string si to consist of a sequence of zero or more text 
tokens separated by spans of one or more characters from the separator string 
s2. The first call (with pointer si specified) returns a pointer to the first char- 
acter of the first token, and will have written a null character into si immedi- 
ately following the returned token. The function keeps track of its position in 
the string between separate calls, so that subsequent calls (which must be made 
with the first argument a NULL pointer) will work through the string si 
immediately following that token. In this way subsequent calls will work 
through the string si until no tokens remain. The separator string s2 may be 
different from call to call. When no token remains in si, a NULL pointer is 
returned. 

NOTE 

For user convenience, all these functions are declared in the optional 
<string.h> header file. 

BUGS 

Strcmp and strncmp use native character comparison, which is signed on PDP- 
11s and VAX-1 Is, unsigned on other machines. Thus the sign of the value 
returned when one of the characters has its high-order bit set is 
implementation-dependent. 

Character movement is performed differently in different implementations. 
Thus overlapping moves may yield surprises. 
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NAME 

strtod, atof — convert string to double-precision number 
SYNOPSIS 

double strtod (str, ptr) 
char *str, **ptr; 

double atof (str) 
char *str; 

DESCRIPTION 

Strtod returns as a double-precision floating-point number the value 
represented by the character string pointed to by str. The string is scanned up 
to the first unrecognized character. 

Strtod recognizes an optional string of “white-space” characters (as defined by 
isspace in ctypei 3C)), then an optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E followed by an optional sign 
or space, followed by an integer. 

If the value of ptr is not (char **)NULL, a pointer to the character terminating 
the scan is returned in the location pointed to by ptr. If no number can be 
formed, *ptr is set to str, and zero is returned. 

Atof(str) is equivalent to str tod (str, (char **)NULL). 

SEE ALSO 

ctype(3C), scanf(3S), strtol(3C). 

DIAGNOSTICS 

If the correct value would cause overflow, ±huge is returned (according to the 
sign of the value), and errno is set to ERANGE. 

If the correct value would cause underflow, zero is returned and errno is set to 
ERANGE. 
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NAME 

strtol, atol, atoi — convert string to integer 
SYNOPSIS 

long strtol (str, ptr, base) 
char »str, »*ptr; 
int base; 

long atol (str) 
char *str; 

int atoi (str) 
char »str; 

DESCRIPTION 

Strtol returns as a long integer the value represented by the character string 
pointed to by str. The string is scanned up to the first character inconsistent 
with the base. Leading “white-space” characters (as defined by isspace in 
ctype( 3C)) are ignored. 

If the value of ptr is not (char *»)NULL, a pointer to the character terminating 
the scan is returned in the location pointed to by ptr. If no integer can be 
formed, that location is set to str , and zero is returned. 

If base is positive (and not greater than 36), it is used as the base for conver- 
sion. After an optional leading sign, leading zeros are ignored, and “Ox” or 
“OX” is ignored if base is 16. 

If base is zero, the string itself determines the base thusly: After an optional 
leading sign a leading zero indicates octal conversion, and a leading “Ox” or 
“OX” hexadecimal conversion. Otherwise, decimal conversion is used. 

Truncation from long to int can, of course, take place upon assignment or by an 
explicit cast. 

Atol(str) is equivalent to strtoKstr, (char **)NULL, 10) . 

Atoi (str) is equivalent to (int) strtol (str, (char **)NULL, 10). 

SEE ALSO 

ctype(3C), scanf(3S), strtod(3C). 

BUGS 

Overflow conditions are ignored. 
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NAME 

swab — swap bytes 
SYNOPSIS 

void swab (from, to, nbytes) 
char •from, »to; 
int nbytes; 

DESCRIPTION 

Swab copies nbytes bytes pointed to by from to the array pointed to by to, 
exchanging adjacent even and odd bytes. It is useful for carrying binary data 
between PDP-lls and other machines. Nbytes should be even and non- 
negative. If nbytes is odd and positive swab uses nbytes - 1 instead. If nbytes is 
negative, swab does nothing. 
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NAME 

system — issue a shell command 

SYNOPSIS 

#include <stdio.h> 

int system (string) 
char ‘string; 

DESCRIPTION 

System causes the string to be given to sh{ 1) as input, as if the string had 
been typed as a command at a terminal. The current process waits until the 
shell has completed, then returns the exit status of the shell. 

FILES 

/bin/sh 


SEE ALSO 

exec(2). 

sh(l) in the UNIX System User Reference Manual. 

DIAGNOSTICS 

System forks to create a child process that in turn exec’s /bin/sh in order to 
execute string. If the fork or exec fails, system returns a negative value and 
sets errno. 


- 1 - 



TMPFILE(3S) 


TMPFILE (3S) 


NAME 

tmpfile — create a temporary file 

SYNOPSIS 

#include <stdio.h> 

FILE • tmpfile 0 
DESCRIPTION 

Tmpfile creates a temporary file using a name generated by tmpnamOS), and 
returns a corresponding FILE pointer. If the file cannot be opened, an error 
message is printed using perrori 3C), and a NULL pointer is returned. The file 
will automatically be deleted when the process using it terminates. The file is 
opened for update ("w+"). 

SEE ALSO 

creat(2), unlink(2), fopen(3S), mktemp(3C), perror(3C), tmpnamOS). 
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NAME 

tmpnam, tempnam — create a name for a temporary file 

SYNOPSIS 

#include <stdio.h> 

char •tmpnam (s) 
char »s; 

char »tempnam (dir, pfx) 
char *dir, »pfx; 

DESCRIPTION 

These functions generate file names that can safely be used for a temporary 
file. 

Tmpnam always generates a file name using the path-prefix defined as 
Ptmpdir in the <stdio.h> header file. If s is NULL, tmpnam leaves its result 
in an internal static area and returns a pointer to that area. The next call to 
tmpnam will destroy the contents of the area. If 5 is not NULL, it is assumed 
to be the address of an array of at least L tmpnam bytes, where L_tmpnam is a 
constant defined in <stdio.h>\ tmpnam places its result in that array and 
returns s. 

Tempnam allows the user to control the choice of a directory. The argument 
dir points to the name of the directory in which the file is to be created. If dir 
is NULL or points to a string which is not a name for an appropriate directory, 
the path-prefix defined as P tmpdir in the <stdio.h> header file is used. If 
that directory is not accessible, /tmp will be used as a last resort. This entire 
sequence can be up-staged by providing an environment variable TMPDIR in 
the user’s environment, whose value is the name of the desired temporary-file 
directory. 

Many applications prefer their temporary files to have certain favorite initial 
letter sequences in their names. Use the pfx argument for this. This argument 
may be NULL or point to a string of up to five characters to be used as the first 
few characters of the temporary-file name. 

Tempnam uses mallocihC) to get space for the constructed file name, and 
returns a pointer to this area. Thus, any pointer value returned from tempnam 
may serve as an argument to free (see maIloc(3C)) . If tempnam cannot 
return the expected result for any reason, i.e. mallocOC) failed, or none of 
the above mentioned attempts to find an appropriate directory was successful, a 
NULL pointer will be returned. 

NOTES 

These functions generate a different file name each time they are called. 

Files created using these functions and either fopeni 3S) or creat (2) are tem- 
porary only in the sense that they reside in a directory intended for temporary 
use, and their names are unique. It is the user’s responsibility to use unlink (2) 
to remove the file when its use is ended. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), malloc(3C), mktemp(3C), tmpfile(3S). 

BUGS 

If called more than 17,576 times in a single process, these functions will start 
recycling previously used names. 

Between the time a file name is created and the file is opened, it is possible for 
some other process to create a file with the same name. This can never happen 
if that other process is using these functions or mktemp, and the file names are 
chosen so as to render duplication by other means unlikely. 
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NAME 

tsearch, tfind, tdelete, twalk — manage binary search trees 
SYNOPSIS 

#include <search.h> 

char *tsearch ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 

char * tfind ((char •) key, (char »*) rootp, compar) 
int (‘compar) ( ); 

char ‘tdelete ((char •) key, (char »•) rootp, compar) 
int (‘compar) ( ); 

void twalk ((char *) root, action) 
void (‘action) ( ); 

DESCRIPTION 

Tsearch, tfind, tdelete, and twalk are routines for manipulating binary search 
trees. They are generalized from Knuth (6.2.2) Algorithms T and D. All com- 
parisons are done with a user-supplied routine. This routine is called with two 
arguments, the pointers to the elements being compared. It returns an integer 
less than, equal to, or greater than 0, according to whether the first argument is 
to be considered less than, equal to or greater than the second argument. The 
comparison function need not compare every byte, so arbitrary data may be 
contained in the elements in addition to the values being compared. 

Tsearch is used to build and access the tree. Key is a pointer to a datum to be 
accessed or stored. If there is a datum in the tree equal to ‘key (the value 
pointed to by key), a pointer to this found datum is returned. Otherwise, ‘key 
is inserted, and a pointer to it returned. Only pointers are copied, so the calling 
routine must store the data. Rootp points to a variable that points to the root 
of the tree. A NULL value for the variable pointed to by rootp denotes an 
empty tree; in this case, the variable will be set to point to the datum which 
will be at the root of the new tree. 

Like tsearch , tfind will search for a datum in the tree, returning a pointer to it 
if found. However, if it is not found, tfind will return a NULL pointer. The 
arguments for tfind are the same as for tsearch. 

Tdelete deletes a node from a binary search tree. The arguments are the same 
as for tsearch. The variable pointed to by rootp will be changed if the deleted 
node was the root of the tree. Tdelete returns a pointer to the parent of the 
deleted node, or a NULL pointer if the node is not found. 

Twalk traverses a binary search tree. Root is the root of the tree to be 
traversed. (Any node in a tree may be used as the root for a walk below that 
node.) Action is the name of a routine to be invoked at each node. This rou- 
tine is, in turn, called with three arguments. The first argument is the address 
of the node being visited. The second argument is a value from an enumeration 
data type typedef enum { preorder, postorder, endorder, leaf } VISIT; (defined 
in the <search.h> header file), depending on whether this is the first, second 
or third time that the node has been visited (during a depth-first, left-to-right 
traversal of the tree), or whether the node is a leaf. The third argument is the 
level of the node in the tree, with the root being level zero. 

The pointers to the key and the root of the tree should be of type pointer-to- 
element, and cast to type pointer-to-character. Similarly, although declared as 
type pointer-to-character, the value returned should be cast into type pointer- 
to-element. 
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EXAMPLE 

The following code reads in strings and stores structures containing a pointer to 
each string and a count of its length. It then walks the tree, printing out the 
stored strings and their lengths in alphabetical order. 

#include < search. h> 

#include <stdio.h> 

struct node { /» pointers to these are stored in the tree »/ 

char ‘string; 
int length; 

}; 

char string_space[ 10000]; /* space to store strings */ 

struct node nodes[500]; /» nodes to store »/ 

struct node ‘root = NULL; /* this points to the root */ 

main( ) 

( 

char »strptr = string space; 
struct node ‘nodeptr = nodes; 
void print_node( ), twalk( ); 
int i = 0, node_compare( ); 

while (gets(strptr) != NULL && i++ < 500) { 

/* set node */ 

nodeptr— > string = strptr; 

nodeptr— > length = strlen (strptr); 

/* put node into the tree »/ 

(void) tsearch((char ») nodeptr, &root, 
nodecompare); 

/» adjust pointers, so we don’t overwrite tree */ 
strptr += nodeptr— > length + 1; 
nodeptr++; 

} 

twalk(root, print_node); 

} 

/* 

This routine compares two nodes, based on an 
alphabetical ordering of the string field. 

»/ 

int 

node_compare(nodel, node2) 
struct node *nodel, *node2; 

{ 

return strcmp(nodel — >string, node2— > string); 

) 

/* 

This routine prints out a node, the first time 
twalk encounters it. 

*/ 
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void 

print_node(node, order, level) 
struct node *»node; 

VISIT order; 
int level; 

{ 

if (order == preorder II order == leaf) { 

(void)printf ("string = %20s, length = %d\n", 
(♦node) — > string, (»node) — > length) ; 

} 

SEE ALSO 

bsearch(3C), hsearch(3C), lsearch(3C). 

DIAGNOSTICS 

A NULL pointer is returned by tsearch if there is not enough space available to 
create a new node. 

A NULL pointer is returned by tsearch, tfind and tdelete if rootp is NULL on 
entry. 

If the datum is found, both tsearch and tfind return a pointer to it. If not, 
tfind returns NULL, and tsearch returns a pointer to the inserted item. 

WARNINGS 

The root argument to twalk is one level of indirection less than the rootp argu- 
ments to tsearch and tdelete. 

There are two nomenclatures used to refer to the order in which tree nodes are 
visited. Tsearch uses preorder, postorder and endorder to respectively refer to 
visting a node before any of its children, after its left child and before its right, 
and after both its children. The alternate nomenclature uses preorder, inorder 
and postorder to refer to the same visits, which could result in some confusion 
over the meaning of postorder. 

BUGS 

If the calling function alters the pointer to the root, results are unpredictable. 
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NAME 

ttyname, isatty — find name of a terminal 
SYNOPSIS 

char *ttyname (tildes) 
int tildes; 

int isatty (tildes) 
int tildes; 

DESCRIPTION 

Ttyname returns a pointer to a string containing the null-terminated path name 
of the terminal device associated with file descriptor fildes. 

Isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 

FILES 

/dev/* 

DIAGNOSTICS 

Ttyname returns a NULL pointer if fildes does not describe a terminal device 
in directory /dev. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

ttyslot — find the slot in the utmp file of the current user 

SYNOPSIS 

int ttyslot ( ) 

DESCRIPTION 

Ttyslot returns the index of the current user’s entry in the /etc/utmp file. This 
is accomplished by actually scanning the file /etc/inittab for the name of the 
terminal associated with the standard input, the standard output, or the error 
output (0, 1 or 2). 

FILES 

/etc/inittab 

/etc/utmp 

SEE ALSO 

getut(3C), ttyname(3C). 

DIAGNOSTICS 

A value of 0 is returned if an error was encountered while searching for the 
terminal name or if none of the above file descriptors is associated with a termi- 
nal device. 
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NAME 

ungetc — push character back into input stream 

SYNOPSIS 

#include <stdio.h> 

int ungetc (c, stream) 
int c; 

FILE ‘stream; 

DESCRIPTION 

Ungetc inserts the character c into the buffer associated with an input stream. 
That character, c, will be returned by the next getc(3S) call on that stream. 
Ungetc returns c, and leaves the file stream unchanged. 

One character of pushback is guaranteed, provided something has already been 
read from the stream and the stream is actually buffered. In the case that 
stream is stdin, one character may be pushed back onto the buffer without a 
previous read statement. 

If c equals EOF, ungetc does nothing to the buffer and returns EOF. 

Fseeki 3S) erases all memory of inserted characters. 

SEE ALSO 

fseek(3S), getc(3S), setbuf(3S). 

DIAGNOSTICS 

Ungetc returns EOF if it cannot insert the character. 
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NAME 

vprintf, vfprintf, vsprintf - print formatted output of a varargs argument list 
SYNOPSIS 

#include <stdio.h> 

#include <varargs.h> 

int vprintf (format, ap) 
char ‘format; 
vajist ap; 

int vfprintf (stream, format, ap) 

FILE ‘stream; 
char ‘format; 
vajist ap; 

int vsprintf (s, format, ap) 
char »s, ‘format; 
vajist ap; 

DESCRIPTION 

vprintf , vfprintf, and vsprintf are the same as printf, fprintf, and sprintf 
respectively, except that instead of being called with a variable number of argu- 
ments, they are called with an argument list as defined by varargs (.5). 

EXAMPLE 

The following demonstrates how vfprintf could be used to write an error rou- 
tine. 

#include <stdio.h> 

#include < varargs. h> 


/* 

* error should be called like 

* error (function name, format, argl, arg2...); 

*/ 

/•VARARGSO*/ 

void 

error (vaalist) 

/* Note that the function name and format arguments cannot be 

* separately declared because of the definition of varargs. 

*/ 

va del 

( 

vajist args; 
char *fmt; 

va_start(args); 

/* print out name of function causing error */ 

(void) fprintf (stderr, "ERROR in %s: ", va_arg(args, char *)); 
fmt = va_arg(args, char »); 

/* print out remainder of message */ 

(void) vfprintf (fmt, args); 
va_end (args) ; 

(void) abort ( ); 

} 

SEE ALSO 

vprintf (3X), varargs (5). 
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NAME 

jO, jl, jn, yO, yl, yn — Bessel functions 

SYNOPSIS 

#include <math.h> 

double jO (x) 
double x; 

double jl (x) 
double x; 

double jn (n, x) 
int n; 
double x; 

double yO (x) 
double x; 

double yl (x) 
double x; 

double yn (n, x) 
int n; 
double x; 

DESCRIPTION 

JO and jl return Bessel functions of x of the first kind of orders 0 and 1 
respectively. Jn returns the Bessel function of x of the first kind of order n. 

YO and yl return Bessel functions of x of the second kind of orders 0 and 1 
respectively. Yn returns the Bessel function of x of the second kind of order n. 
The value of x must be positive. 

DIAGNOSTICS 

Non-positive arguments cause yO, yl and yn to return the value -HUGE and to 
set errno to EDOM. In addition, a message indicating DOMAIN error is printed 
on the standard error output. 

Arguments too large in magnitude cause jO,jl, yO and yl to return zero and to 
set errno to ERANGE. In addition, a message indicating TLOSS error is printed 
on the standard error output. 

These error-handling procedures may be changed with the function 
matherr{ 3M). 

SEE ALSO 

matherr(3M). 
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NAME 

erf, erfc — error function and complementary error function 

SYNOPSIS 

#include <math.h> 

double erf (x) 
double x; 

double erfc (x) 
double x; 


DESCRIPTION 

Erf returns the error function of x, defined as 



Erfc , which returns 1 .0 — erf(x), is provided because of the extreme loss of 
relative accuracy if erf(x) is called for large x and the result subtracted from 
1.0 (e.g., for x = 5, 12 places are lost). 


SEE ALSO 

exp(3M). 
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NAME 

exp, log, log 10, pow, sqrt — exponential, logarithm, power, square root functions 

SYNOPSIS 

#include <math.h> 

double exp (x) 
double x; 

double log (x) 
double x; 

double loglO (x) 
double x; 

double pow (x, y) 
double x, y; 

double sqrt (x) 
double x; 

DESCRIPTION 

Exp returns e x . 

Log returns the natural logarithm of x. The value of x must be positive. 

LoglO returns the logarithm base ten of x. The value of x must be positive. 

Pow returns x y . If x is zero, y must be positive. If x is negative, y must be an 
integer. 

Sqrt returns the non-negative square root of x. The value of x may not be 
negative. 

DIAGNOSTICS 

Exp returns HUGE when the correct value would overflow, or 0 when the 
correct value would underflow, and sets errno to ERANGE. 

Log and loglO return -HUGE and set errno to EDOM when x is non-positive. 
A message indicating DOMAIN error (or SING error when x is 0) is printed on 
the standard error output. 

Pow returns 0 and sets errno to EDOM when x is 0 and y is non-positive, or 
when x is negative and y is not an integer. In these cases a message indicating 
DOMAIN error is printed on the standard error output. When the correct value 
for pow would overflow or underflow, pow returns ±HUGE or 0 respectively, 
and sets errno to ERANGE. 

Sqrt returns 0 and sets errno to EDOM when x is negative. A message indicat- 
ing DOMAIN error is printed on the standard error output. 

These error-handling procedures may be changed with the function 
mat herr (3M) . 

SEE ALSO 

hypot(3M), matherr(3M), sinh(3M). 
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NAME 

floor, ceil, fmod, fabs — floor, ceiling, remainder, absolute value functions 

SYNOPSIS 

#include <math.h> 

double floor (x) 
double x; 

double ceil (x) 
double x; 

double fmod (x, y) 
double x, y; 

double fabs (x) 
double x; 

DESCRIPTION 

Floor returns the largest integer (as a double-precision number) not greater 
than x. 

Ceil returns the smallest integer not less than x. 

Fmod returns the floating-point remainder of the division of x by y: zero if y is 
zero or if x/y would overflow; otherwise the number / with the same sign as x, 
such that x = iy + f for some integer i, and [/"I < \y\. 

Fabs returns the absolute value of x, |x|. 

SEE ALSO 

abs(3C). 
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NAME 

gamma — log gamma function 

SYNOPSIS 

#include <math.h> 

double gamma (x) 
double x; 

extern int signgam; 

DESCRIPTION 

Gamma returns ln(|r(x)|), where T(x) is defined as Je~'t x ~'dt. The sign of 

0 

TU) is returned in the external integer signgam. The argument x may not be 
a non-positive integer. 

The following C program fragment might be used to calculate T: 

if ((y = gamma (x)) > LNMAXDOUBLE) 
errorO; 

y = signgam * exp(y); 

where LN MAXDOUBLE is the least value that causes exp{ 3M) to return a 
range error, and is defined in the <values.h> header file. 

DIAGNOSTICS 

For non-negative integer arguments HUGE is returned, and errno is set to 
EDOM. A message indicating SING error is printed on the standard error out- 
put. 

If the correct value would overflow, gamma returns HUGE and sets errno to 
ERANGE. 

These error-handling procedures may be changed with the function 
matherri 3M). 

SEE ALSO 

exp(3M), matherr(3M), values(5). 
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NAME 

hypot — Euclidean distance function 

SYNOPSIS 

#include <math.h> 

double hypot (x, y) 
double x, y; 

DESCRIPTION 

Hypot returns 

sqrt(x * x + y * y), 

taking precautions against unwarranted overflows. 

DIAGNOSTICS 

When the correct value would overflow, hypot returns HUGE and sets errno to 
ERANGE. 

These error-handling procedures may be changed with the function 
matherr(3M) . 

SEE ALSO 

matherr(3M). 
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NAME 

matherr — error-handling function 

SYNOPSIS 

#include <math.h> 

int matherr (x) 
struct exception *x; 

DESCRIPTION 

Matherr is invoked by functions in the Math Library when errors are detected. 
Users may define their own procedures for handling errors, by including a func- 
tion named matherr in their programs. Matherr must be of the form described 
above. When an error occurs, a pointer to the exception structure x will be 
passed to the user-supplied matherr function. This structure, which is defined 
in the <math.h> header file, is as follows: 

struct exception ( 
int type; 
char *name; 

double argl, arg2, retval; 


The element type is an integer describing the type of error that has occurred, 
from the following list of constants (defined in the header file): 


DOMAIN 

SING 

OVERFLOW 

UNDERFLOW 

TLOSS 

PLOSS 


argument domain error 
argument singularity 
overflow range error 
underflow range error 
total loss of significance 
partial loss of significance 


The element name points to a string containing the name of the function that 
incurred the error. The variables argl and arg2 are the arguments with which 
the function was invoked. Retval is set to the default value that will be 
returned by the function unless the user’s matherr sets it to a different value. 


If the user’s matherr function returns non-zero, no error message will be 
printed, and errno will not be set. 


If matherr is not supplied by the user, the default error-handling procedures, 
described with the math functions involved, will be invoked upon error. These 
procedures are also summarized in the table below. In every case, errno is set 
to EDOM or ERANGE and the program continues. 

EXAMPLE 

#include <math.h> 


int 

matherr (x) 

register struct exception *x; 

switch (x— >type) { 
case DOMAIN: 

/« change sqrt to return sqrt(— argl), not 0 «/ 
if (!strcmp(x— >name, "sqrt")) { 

x— > retval = sqrt (— x— > argl); 

^ return (0); /* print message and set errno */ 

case SING: 

/» all other domain or sing errors, print message and abort »/ 
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fprintf(stderr, "domain error in %s\n", x— >name); 
abort ( ); 
case PLOSS: 

/« print detailed error message »/ 
fprintf(stderr, "loss of significance in %s(%g) = %g\n", 
x— >name, x— >argl, x— >retval); 
return (1); /* take no other action */ 

} 

return (0); /* all other errors, execute default procedure */ 

) 


DEFAULT ERROR HANDLING PROCEDURES 


Types of Errors 

type 

DOMAIN 

SING 

OVERFLOW 

UNDERFLOW 

TLOSS 

PLOSS 

errno 

EDOM 

EDOM 

ERANGE 

ERANGE 

ERANGE 

ERANGE 

BESSEL: 

- 

- 

- 

- 


* 

yO, yl, yn (arg < 0) 

M, -H 

- 

- 

- 

- 

- 

EXP: 

- 

- 

H 

0 

- 

- 

LOG, LOG 10: 







(arg < 0) 


- 

- 

- 

- 

- 

(arg = 0) 



- 

- 

- 

- 

POW: 

- 

1 

±H 

0 

- 

- 

neg ** non-int 

M, 0 

- 

- 

- 

- 

- 

0 ** non-pos 







SQRT: 

M, 0 

- 

- 

- 

- 

- 

GAMMA: 

- 

M, H 

H 

- 

- 

- 

HYPOT: 

- 

- 

H 

- 

- 

- 

5INH: 

- 

- 

±H 

- 

- 

- 

COSH: 

- 

- 

H 

- 

- 

- 

SIN, COS, TAN: - 

- 

- 

- 

M, 0 

* 


ASIN, ACOS, ATAN2: M, 0 

- 

- 

- 

- 

- 





ABBREVIATIONS 

* 

As much as possible of the value is returned. 

M 

Message is printed (EDOM error). 

H 

HUGE is returned. 

-H 

—HUGE is returned. 

±H 

HUGE or —HUGE is returned. 

0 

0 is returned. 
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NAME 

sinh, cosh, tanh — hyperbolic functions 
SYNOPSIS 

#inc)ude <math.h> 

double sinh (x) 
double x; 

double cosh (x) 
double x; 

double tanh (x) 
double x; 

DESCRIPTION 

Sinh, cosh, and tanh return, respectively, the hyberbolic sine, cosine and 
tangent of their argument. 

DIAGNOSTICS 

Sinh and cosh return HUGE (and sinh may return “HUGE for negative x) 
when the correct value would overflow and set errno to ERANGE. 

These error-handling procedures may be changed with the function 
matherr (3M) . 

SEE ALSO 

matherr(3M). 



TRIG (3M) 


TRIGC3M) 


NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions 

SYNOPSIS 

#include <math.h> 

double sin (x) 
double x; 

double cos (x) 
double x; 

double tan (x) 
double x; 

double asin (x) 
double x; 

double acos (x) 
double x; 

double atan (x) 
double x; 

double atan2 (y, x) 
double y, x; 

DESCRIPTION 

Sin, cos and tan return respectively the sine, cosine and tangent of their argu- 
ment, x, measured in radians. 

Asin returns the arcsine of x, in the range —ir/2 to ir/2. 

Acos returns the arccosine of x, in the range 0 to ir. 

Atan returns the arctangent of x, in the range —ir/2 to tt/2. 

Atan2 returns the arctangent of y/x , in the range — i r to it, using the signs of 
both arguments to determine the quadrant of the return value. 

DIAGNOSTICS 

Sin, cos, and tan lose accuracy when their argument is far from zero. For 
arguments sufficiently large, these functions return zero when there would oth- 
erwise be a complete loss of significance. In this case a message indicating 
TLOSS error is printed on the standard error output. For less extreme argu- 
ments causing partial loss of significance, a PLOSS error is generated but no 
message is printed. In both cases, errno is set to ERANGE. 

If the magnitude of the argument of asin or acos is greater than one, or if both 
arguments of atan2 are zero, zero is returned and errno is set to EDOM. In 
addition, a message indicating DOMAIN error is printed on the standard error 
output. 

These error-handling procedures may be changed with the function 
matherri, 3M). 

SEE ALSO 

matherr(3M). 
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NAME 

assert — verify program assertion 

SYNOPSIS 

#include <assert.h> 

assert (expression) 
int expression; 

DESCRIPTION 

This macro is useful for putting diagnostics into programs. When it is exe- 
cuted, if expression is false (zero), assert prints 

“Assertion failed: expression, file xyz, line nnn" 

on the standard error output and aborts. In the error message, xyz is the name 
of the source file and nnn the source line number of the assert statement. 

Compiling with the preprocessor option — DNDEBUG (see cpp( 1)), or with the 
preprocessor control statement “#define NDEBUG” ahead of the “#include 
<assert.h>” statement, will stop assertions from being compiled into the pro- 
gram. 

SEE ALSO 

abort (3C). 

cpp(l) in the UNIX System V User Reference Manual. 
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NAME 

curses — CRT screen handling and optimization package 

SYNOPSIS 

#include <curses.h> 

cc [ flags ] files -Icurses [ libraries ] 

DESCRIPTION 

These routines give the user a method of updating screens with reasonable 
optimization. In order to initialize the routines, the routine initscrO must be 
called before any of the other routines that deal with windows and screens are 
used. The routine endwinO should be called before exiting. To get character- 
at-a-time input without echoing, (most interactive, screen oriented-programs 
want this) after calling initscrO you should call “nonlO; cbreakO; noechoO;” 

The full curses interface permits manipulation of data structures called win- 
dows which can be thought of as two dimensional arrays of characters 
representing all or part of a CRT screen. A default window called stdscr is sup- 
plied, and others can be created with newwin. Windows are referred to by vari- 
ables declared “WINDOW the type WINDOW is defined in curses. h to be a 
C structure. These data structures are manipulated with functions described 
below, among which the most basic are move, and addch. (More general ver- 
sions of these functions are included with names beginning with ‘w\ allowing 
you to specify a window. The routines not beginning with ‘w’ affect stdscr.) 
Then refreshO is called, telling the routines to make the users CRT screen look 
like stdscr. 

Mini-Curses is a subset of curses which does not allow manipulation of more 
than one window. To invoke this subset, use -DMINICURSES as a cc option. 
This level is smaller and faster than full curses. 

If the environment variable TERMINFO is defined, any program using curses 
will check for a local terminal definition before checking in the standard place. 
For example, if the standard place is /usr/lib/terminfo, and TERM is set to 
“vtlOO”, then normally the compiled file is found in /usr/lib/terminfo/v/vtlOO. 
(The “v” is copied from the first letter of “vtlOO” to avoid creation of huge 
directories.) However, if TERMINFO is set to /usr/mark/myterms, curses will 
first check /opusr/mark/myterms/v/vtlOO, and if that fails, will then check 
/usr/lib/terminfo/v/vtlOO. This is useful for developing experimental 
definitions or when write permission in /usr/lib/terminfo is not available. 

SEE ALSO 

terminfo(4). 

FUNCTIONS 

Routines listed here 
with an asterisk may 

addch (ch)* 

addstr(str)* 
attroff(attrs)* 
attron(attrs)* 
attrset(attrs)* 
baudrateO* 
beepO* 

box(win, vert, hor) 


clear!) 

clearok(win, bf) 


may be called when using the full curses. Those marked 
be called when using Mini-Curses. 

add a character to stdscr (like putchar) 

(wraps to next line at end of line) 

calls addch with each character in str 

turn off attributes named 

turn on attributes named 

set current attributes to attrs 

current terminal speed 

sound beep on terminal 

draw a box around edges of win 

vert and hor are chars to use for vert, and 

hor. edges of box 

clear stdscr 

clear screen before next redraw of win 
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clear to bottom of stdscr 
clear to end of line on stdscr 
set cbreak mode 

insert ms millisecond pause in output 
delete a character 
delete a line 
delete win 

update screen from all wnooutrefresh 
set echo mode 
end window modes 
erase stdscr 

return user’s erase character 
restore tty to "in curses" state 
flash screen or beep 
throw away any typeahead 
get a char from tty 
get a string through stdscr 
establish current tty modes 
get (y, x) co-ordinates 
true if terminal can do insert character 
true if terminal can do insert line 
use terminal’s insert/delete line if bf != 0 
get char at current (y, x) co-ordinates 
initialize screens 
insert a char 
insert a line 

interrupts flush output if bf is TRUE 
enable keypad input 
return current user’s kill character 
OK to leave cursor anywhere after refresh if 
flag!=0 for win , otherwise cursor must be left 
at current position, 
return verbose name of terminal 
allow meta characters on input if flag != 0 
move to (y, x) on stdscr 
move(y, x) then addch(ch) 
similar... 

mvcur(oldrow, oldcol, newrow, newcoOlow level cursor motion 

mvdelch(y, x) like delch, but movefy, x) first 

mvgetch(y, x) etc. 

mvgetstr(y, x) 

mvinch(y, x) 

mvinsch(y, x, c) 

mvprintw(y, x, fmt, args) 

mvscanw(y, x, fmt, args) 

mvwaddch(win, y, x, ch) 

mvwaddstr(win, y, x, str) 

mvwdelch(win, y, x) 

mvwgetch(win, y, x) 

mvwgetstrfwin, y, x) 

mvwin(win, by, bx) 

mvwinchfwin, y, x) 

mvwinschfwin, y, x, c) 

mvwprintw(win, y, x, fmt, args) 

mvwscanw(win, y, x, fmt, args) 

newpad (nlines, ncols) create a new pad with given dimensions 

newtermftype, fd) set up new terminal of given type to output on fd 


clrtobotO 

clrtoeolO 

cbreakO* 

delayoutput(ms)* 

delch () 

deletelnO 

delwin(win) 

doupdateO 

echoO* 

endwinO * 

eraseO 

erasecharO 

fixtermO 

flash 0 

flushinpO* 

getchO* 

getstr(str) 

gettmodeO 

getyx(win, y, x) 

hasJcO 

hasJlO 

idlokfwin, bf)* 

inchO 

initscrO* 

insch(c) 

insertlnO 

intrflush(win, bf) 

keypad (win, bf) 

killcharO 

leaveok(win, flag) 


longnameO 
meta (win, flag)* 
move(y, x)* 
mvaddch(y, x, ch) 
mvaddstr(y, x, str) 
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n (lines, cols, begin_y, begin_x) create a new window 


nlO* 

nocbreakO* 
nodelay(win, bf) 
noechoO* 
nonlO* 
norawO* 

overlay (win 1, win2) 
overwrite(winl, win2) 


set newline mapping 
unset cbreak mode 

enable nodelay input mode through getch 
unset echo mode 
unset newline mapping 
unset raw mode 
overlay winl on win2 
overwrite winl on top of win2 
pnoutrefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 

like prefresh but with no output until doupdate called 
prefresh (pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 

refresh from pad starting with given upper left corner of pad 
with output to given portion of screen 
.) printf on stdscr 
set raw mode 

make current screen look like stdscr 
set tty modes to "out of curses" state 
reset tty flags to stored value 
save current modes as "in curses" state 
store current tty flags 
scanf through stdscr 
scroll win one line 
allow terminal to scroll if flag != 0 
now talk to terminal new 
set user scrolling region to lines t through b 
establish terminal with given type 
filenum, errret) 

clear standout mode attribute 
set standout mode attribute 


printw(fmt, argl, arg2, 
rawO* 
refreshO* 
resettermO* 
resettyO* 
savetermO* 
savettyO* 

scanw(fmt, argl, arg2, ...) 
scroll (win) 
scrollok(win, flag) 
set term (new) 
setscrreg(t, b) 
setterm(type) 
setupterm(term 
standendO* 
standoutO* 


subwin(win, lines, cols, begin_y, begin_x) create a subwindow 


touchwin(win) 
traceoffO 
traceonO 
typeahead(fd) 
unctrl(ch)* 
waddch(win, ch) 
waddstr(win, str) 
wattroff(win, attrs) 
wattron(win, attrs) 
wattrset(win, attrs) 
wclear(win) 
wclrtobot(win) 
wclrtoeol(win) 
wdelch(win, c) 
wdeleteln(win) 
werase(win) 
wgetch(win) 
wgetstr(win, str) 
winch (win) 
winsch(win, c) 
winsertln(win) 
wmove(win, y, x) 
wnoutrefresh (win) 


change all of win 

turn off debugging trace output 

turn on debugging trace output 

use file descriptor fd to check typeahead 

printable version of ch 

add char to win 

add string to win 

turn off attrs in win 

turn on attrs in win 

set attrs in win to attrs 

clear win 

clear to bottom of win 
clear to end of line on win 
delete char from win 
delete line from win 
erase win 

get a char through win 

get a string through win 

get char at current (y, x) in win 

insert char into win 

insert line into win 

set current (y, x) co-ordinates on win 
refresh but no screen output 


wprintw(win, fmt, argl, arg2, ...) printf on win 
wrefresh(win) make screen look like win 

wscanw(win, fmt, argl, arg2, ...) scanf through win 


- 3 - 



CURSES (3X) 


CURSES (3X) 


wsetscrreg(win, t, b) set scrolling region of win 

wstandend(win) clear standout attribute in win 

wstandout(win) set standout attribute in win 

TERMINFO LEVEL ROUTINES 

These routines should be called by programs wishing to deal directly with the 
terminfo database. Due to the low level of this interface, it is discouraged. Ini- 
tially, setupterm should be called. This will define the set of terminal depen- 
dent variables defined in terminfo(4). The include files <curses.h> and 
<term.h> should be included to get the definitions for these strings, numbers, 
and flags. Parmeterized strings should be passed through tparm to instantiate 
them. All terminfo strings (including the output of tparm) should be printed 
with tputs or putp . Before exiting, resetterm should be called to restore the tty 
modes. (Programs desiring shell escapes or suspending with control Z can call 
resetterm before the shell is called and fixterm after returning from the shell.) 
fixtermO restore tty modes for terminfo use 

(called by setupterm) 

resetterm 0 reset tty modes to state before program entry 

setupterm (term, fd, rc) read in database. Terminal type is the 

character string term, all output is to UNIX System file 
descriptor fd. A status value is returned in the 
integer pointed to by rc: 1 is normal. The simplest 
call would be setupterm(0, I, 0) which uses all the defaults. 
tparm(str, pi, p2, ..., p9) instantiate string str with parms p.. 
tputs (str, affcnt, putc) apply padding info to string sir. 

affcnl is the number of lines affected, or 1 if 
not applicable. Putc is a putchar-Iike function 
to which the characters are passed, one at a time. 
putp(str) handy function that calls tputs(str, I, putchar). 

vidputs(attrs, putc) output the string to put terminal in video attribute 

mode attrs , which is any combination of the attributes 
listed below. Chars are passed to putchar-like function putc. 
vidattr(attrs) Like vidputs but outputs through putchar 

TERMCAP COMPATIBILITY ROUTINES 

These routines were included as a conversion aid for programs that use 

termcap. Their parameters are the same as for termcap. They are emulated 

using the terminfo database. They may go away at a later date. 

tgetent(bp, name) look up termcap entry for name 

tgetflag(id) get boolean entry for id 

tgetnum(id) get numeric entry for id 

tgetstr(id, area) get string entry for id 

tgoto(cap, col, row) apply parms to given cap 

tputs (cap, affcnt, fn) apply padding to cap calling fn as putchar 

ATTRIBUTES 

The following video attributes can be passed to the functions 
attron,attroff,attrset. 

A STANDOUT Terminal’s best highlighting mode 

AUNDERLINE Underlining 

A REVERSE Reverse video 

ABLINK Blinking 

A_DIM Half bright 

A BOLD Extra bright or bold 

AJBLANK Blanking (invisible) 

APROTECT Protected 

A_ALTCHARSET Alternate character set 
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FUNCTION KEYS 

The following function keys might be returned by getch if keypad has been 
enabled. Note that not all of these are currently supported, due to lack of 
definitions in terminfo or the terminal not transmitting a unique code when the 
key is pressed. 


Name 

Value 

Key name 

KEYBREAK 

0401 

break key (unreliable) 

KEYDOWN 

0402 

The four arrow keys ... 

KEYUP 

0403 


KEYLEFT 

0404 


KEYRIGHT 

0405 


KEYHOME 

0406 

Home key (upward+left arrow) 

KEYBACKSPACE 

0407 

backspace (unreliable) 

KEYFO 

0410 

Function keys. Space for 64 is reserved. 

KEY_F(n) 

(KEY_F0+(n)) 

Formula for fn. 

KEYDL 

0510 

Delete line 

KEY1L 

0511 

Insert line 

KEYDC 

0512 

Delete character 

KEYIC 

0513 

Insert char or enter insert mode 

KEYEIC 

0514 

Exit insert char mode 

KEYCLEAR 

0515 

Clear screen 

KEYEOS 

0516 

Clear to end of screen 

KEYEOL 

0517 

Clear to end of line 

KEYSF 

0520 

Scroll 1 line forward 

KEY SR 

0521 

Scroll 1 line backwards (reverse) 

KEYNPAGE 

0522 

Next page 

KEYPPAGE 

0523 

Previous page 

KEYSTAB 

0524 

Set tab 

KEYCTAB 

0525 

Clear tab 

KEYCATAB 

0526 

Clear all tabs 

KEYENTER 

0527 

Enter or send (unreliable) 

KEYSRESET 

0530 

soft (partial) reset (unreliable) 

KEYRESET 

0531 

reset or hard reset (unreliable) 

KEYPRINT 

0532 

print or copy 

KEY LL 

0533 

home down or bottom (lower left) 


WARNING 

The plotting library plot( 3X) and the curses library curses (3X) both use the 
names eraseO and moveO. The curses versions are macros. If you need both 
libraries, put the plot( 3X) code in a different source file than the curses (3X) 
code, and/or #undef moveO and eraseO in the plot( 3X) code. 
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NAME 

ldahread - read the archive header of a member of an archive file 
SYNOPSIS 

#include <stdio.h> 

#include <ar.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int ldahread (Idptr, arhead) 

LDFILE »ldptr; 

ARCHDR *arhead; 

DESCRIPTION 

If TYPE Udptr) is the archive file magic number, ldahread reads the archive 
header of the common object file currently associated with Idptr into the area 
of memory beginning at arhead. 

Ldahread returns SUCCESS or FAILURE. Ldahread will fail if TYPE Udptr) 
does not represent an archive file, or if it cannot read the archive header. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4), ar(4). 
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NAME 

ldclose, ldaclose — close a common object file 

SYNOPSIS 

#include <stdio.h> 

#inelude <filehdr.h> 

#include <ldfcn.h> 

int ldclose (ldptr) 

LDFILE * ldptr; 

int ldaclose (ldptr) 

LDFILE -ldptr; 

DESCRIPTION 

Ldopenl 3X) and ldclose are designed to provide uniform access to both simple 
object files and object files that are members of archive files. Thus an archive 
of common object files can be processed as if it were a series of simple common 
object files. 

If TYPE (ldptr) does not represent an archive file, ldclose will close the file and 
free the memory allocated to the LDFILE structure associated with ldptr. If 
TYPE (ldptr) is the magic number of an archive file, and if there are any more 
files in the archive, ldclose will reinitialize OFFSET(Wptr) to the file address of 
the next archive member and return FAILURE. The LDFILE structure is 
prepared for a subsequent IdopenOX). In all other cases, ldclose returns SUC- 
CESS. 

Ldaclose closes the file and frees the memory allocated to the LDFILE structure 
associated with ldptr regardless of the value of TYPE (ldptr). Ldaclose always 
returns SUCCESS. The function is often used in conjunction with Idaopen. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

fclose(3S), ldopen(3X), ldfcn(4). 
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NAME 

ldfhread — read the file header of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int ldfhread (ldptr, filehead) 

LDFILE »ldptr; 

FILHDR * filehead; 

DESCRIPTION 

Ldfhread reads the file header of the common object file currently associated 
with ldptr into the area of memory beginning at filehead. 

Ldfhread returns SUCCESS or FAILURE. Ldfhread will fail if it cannot read 
the file header. 

In most cases the use of ldfhread can be avoided by using the macro 
HEADER (/<//>?/•) defined in ldfcn.h (see ldfcn (4)). The information in any 
field, fieldname , of the file header may be accessed using 

HEADER (ldptr) .fieldname. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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NAME 

ldgetname — retrieve symbol name for common object file symbol table entry 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <syms.h> 

#include <ldfcn.h> 

char *ldgetname (Idptr, symbol) 

LDFILE *Idptr; 

SYMENT »symbol; 

DESCRIPTION 

Ldgetname returns a pointer to the name associated with symbol as a string. 
The string is contained in a static buffer local to ldgetname that is overwritten 
by each call to ldgetname, and therefore must be copied by the caller if the 
name is to be saved. 

As of UNIX system release 5.0, the common object file format has been 
extended to handle arbitrary length symbol names with the addition of a 
“string table”. Ldgetname will return the symbol name associated with a sym- 
bol table entry for either a pre-UNIX system 5.0 object file or a UNIX system 
5.0 object file. Thus, ldgetname can be used to retrieve names from object files 
without any backward compatibility problems. Ldgetname will return NULL 
(defined in stdio.h) for a UNIX system 5.0 object file if the name cannot be 
retrieved. This situation can occur: 

— if the “string table” cannot be found, 

— if not enough memory can be allocated for the string table, 

— if the string table appears not to be a string table (for example, if an 
auxiliary entry is handed to ldgetname that looks like a reference to a 
name in a non-existent string table), or 

— if the name’s offset into the string table is past the end of the string 
table. 

Typically, ldgetname will be called immediately after a successful call to 
Idtbread to retrieve the name associated with the symbol table entry filled by 
Idt bread. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), Idtbread (3X), ldtbseek(3X), ldfcn(4). 
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NAME 

ldlread, ldlinit, ldlitem — manipulate line number entries of a common object 
file function 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <linenum.h> 

#include <ldfcn.h> 

int ldlread (Idptr, fcnindx, linenum, linent) 

LDFILE *ldptr; 

long fcnindx; 

unsigned short linenum; 

LINENO linent; 

int ldlinit (Idptr, fcnindx) 

LDFILE *ldptr; 
long fcnindx; 

int ldlitem (Idptr, linenum, linent) 

LDFILE ‘Idptr; 
unsigned short linenum; 

LINENO linent; 

DESCRIPTION 

Ldlread searches the line number entries of the common object file currently 
associated with Idptr. Ldlread begins its search with the line number entry for 
the beginning of a function and confines its search to the line numbers associ- 
ated with a single function. The function is identified by fcnindx, the index of 
its entry in the object file symbol table. Ldlread reads the entry with the smal- 
lest line number equal to or greater than linenum into linent. 

Ldlinit and ldlitem together perform exactly the same function as ldlread. 
After an initial call to ldlread or ldlinit, ldlitem may be used to retrieve a 
series of line number entries associated with a single function. Ldlinit simply 
locates the line number entries for the function identified by fcnindx. Ldlitem 
finds and reads the entry with the smallest line number equal to or greater than 
linenum into linent. 

Ldlread, ldlinit, and ldlitem each return either SUCCESS or FAILURE. 
Ldlread will fail if there are no line number entries in the object file, if fcnindx 
does not index a function entry in the symbol table, or if it finds no line number 
equal to or greater than linenum. Ldlinit will fail if there are no line number 
entries in the object file or if fcnindx does not index a function entry in the 
symbol table. Ldlitem will fail if it finds no line number equal to or greater 
than linenum. 

The programs must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldtbindex(3X), ldfcn(4). 
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NAME 

ldlseek, ldnlseek — seek to line number entries of a section of a common object 
file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#inc)ude <ldfcn.h> 

int ldlseek (Idptr, sectindx) 

LDFILE »ldptr; 
unsigned short sectindx; 

int ldnlseek (Idptr, sectname) 

LDFILE *ldptr; 
char 'sectname; 

DESCRIPTION 

Ldlseek seeks to the line number entries of the section specified by sectindx of 
the common object file currently associated with Idptr. 

Ldnlseek seeks to the line number entries of the section specified by sectname. 

Ldlseek and ldnlseek return SUCCESS or FAILURE. Ldlseek will fail if sec- 
tindx is greater than the number of sections in the object file; ldnlseek will fail 
if there is no section name corresponding with *sectname. Either function will 
fail if the specified section has no line number entries or if it cannot seek to the 
specified line number entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn (4) . 
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NAME 

ldohseek — seek to the optional file header of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int ldohseek (ldptr) 

LDFILE • ldptr; 

DESCRIPTION 

Ldohseek seeks to the optional file header of the common object file currently 
associated with ldptr. 

Ldohseek returns SUCCESS or FAILURE. Ldohseek will fail if the object file 
has no optional header or if it cannot seek to the optional header. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldfhread(3X), ldfcn(4). 
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NAME 

ldopen, ldaopen — open a common object file for reading 

SYNOPSIS 

#inc)ude <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

LDFILE ‘ldopen (filename, ldptr) 
char ‘filename; 

LDFILE ‘ldptr; 

LDFILE ‘ldaopen (filename, oldptr) 
char ‘filename; 

LDFILE *oldptr; 

DESCRIPTION 

Ldopen and ldclose ( 3X) are designed to provide uniform access to both simple 
object files and object files that are members of archive files. Thus an archive 
of common object files can be processed as if it were a series of simple common 
object files. 

If ldptr has the value NULL, then ldopen will open filename and allocate and 
initialize the LDFILE structure, and return a pointer to the structure to the cal- 
ling program. 

If ldptr is valid and if TYPE (ldptr) is the archive magic number, ldopen will 
reinitialize the LDFILE structure for the next archive member of filename. 

Ldopen and Idclosei 3X) are designed to work in concert. Ldclose will return 
FAILURE only when TYPE (ldptr) is the archive magic number and there is 
another file in the archive to be processed. Only then should ldopen be called 
with the current value of ldptr. In all other cases, in particular whenever a 
new filename is opened, ldopen should be called with a NULL ldptr argument. 

The following is a prototype for the use of ldopen and ldclose OX) . 

/* for each filename to be processed */ 

ldptr = NULL; 
do 
{ 

if ( (ldptr = ldopen (filename, ldptr)) != NULL ) 

{ 

/* check magic number »/ 

/* process the file »/ 

} 

) while (ldclose (ldptr) == FAILURE ); 

If the value of oldptr is not NULL, ldaopen will open filename anew and allo- 
cate and initialize a new LDFILE structure, copying the TYPE, OFFSET, and 
HEADER fields from oldptr. Ldaopen returns a pointer to the new LDFILE 
structure. This new pointer is independent of the old pointer, oldptr. The two 
pointers may be used concurrently to read separate parts of the object file. For 
example, one pointer may be used to step sequentially through the relocation 
information, while the other is used to read indexed symbol table entries. 
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Both Idopen and Idaopen open filename for reading. Both functions return 
NULL if filename cannot be opened, or if memory for the LDFILE structure 
cannot be allocated. A successful open does not insure that the given file is a 
common object file or an archived object file. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

fopen(3S), ldclose(3X), ldfcn(4). 
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NAME 

ldrseek, ldnrseek — seek to relocation entries of a section of a common object 
file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

# include <ldfcn.h> 

int ldrseek (ldptr, sectindx) 

LDFILE »ldptr; 
unsigned short sectindx; 

int ldnrseek (ldptr, sectname) 

LDFILE • ldptr; 
char *sectname; 

DESCRIPTION 

Ldrseek seeks to the relocation entries of the section specified by sectindx of 
the common object file currently associated with ldptr. 

Ldnrseek seeks to the relocation entries of the section specified by sectname. 

Ldrseek and ldnrseek return SUCCESS or FAILURE. Ldrseek will fail if sec- 
tindx is greater than the number of sections in the object file; ldnrseek will fail 
if there is no section name corresponding with sectname. Either function will 
fail if the specified section has no relocation entries or if it cannot seek to the 
specified relocation entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn(4). 
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NAME 

ldshread, ldnshread - read an indexed/named section header of a common 
object file 

SYNOPSIS 

#include <stdio.h> 

#include < fllehdr.h > 

#include <scnhdr.h> 

#include <ldfcn.h> 

int ldshread (Idptr, sectindx, secthead) 

LDFILE • Idptr; 
unsigned short sectindx; 

SCNHDR *secthead; 

int ldnshread (Idptr, sectname, secthead) 

LDFILE *ldptr; 
char »sectname; 

SCNHDR *secthead; 

DESCRIPTION 

Ldshread reads the section header specified by sectindx of the common object 
file currently associated with Idptr into the area of memory beginning at sect- 
head. 

Ldnshread reads the section header specified by sectname into the area of 
memory beginning at secthead. 

Ldshread and ldnshread return SUCCESS or FAILURE. Ldshread will fail if 
sectindx is greater than the number of sections in the object file; ldnshread will 
fail if there is no section name corresponding with sectname. Either function 
will fail if it cannot read the specified section header. 

Note that the first section header has an index of one. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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NAME 

ldsseek, ldnsseek - seek to an indexed/named section of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int ldsseek (ldptr, sectindx) 

LDFILE »ldptr; 
unsigned short sectindx; 

int ldnsseek (ldptr, sectname) 

LDFILE »ldptr; 
char *sectname; 

DESCRIPTION 

Ldsseek seeks to the section specified by sectindx of the common object file 
currently associated with ldptr. 

Ldnsseek seeks to the section specified by sectname. 

Ldsseek and ldnsseek return SUCCESS or FAILURE. Ldsseek will fail if sec- 
tindx is greater than the number of sections in the object file; ldnsseek will fail 
if there is no section name corresponding with sectname. Either function will 
fail if there is no section data for the specified section or if it cannot seek to the 
specified section. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn (4) . 
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NAME 

ldtbindex — compute the index of a symbol table entry of a common object file 
SYNOPSIS 

#inc)ude <stdio.h> 

#include <filehdr.h> 

#include <syms.h> 

#include <ldfcn.h> 

long ldtbindex (Idptr) 

LDFILE • Idptr; 

DESCRIPTION 

Ldtbindex returns the (long) index of the symbol table entry at the current 
position of the common object file associated with Idptr. 

The index returned by ldtbindex may be used in subsequent calls to 
ldtbread(3X) . However, since ldtbindex returns the index of the symbol table 
entry that begins at the current position of the object file, if ldtbindex is called 
immediately after a particular symbol table entry has been read, it will return 
the index of the next entry. 

Ldtbindex will fail if there are no symbols in the object file, or if the object file 
is not positioned at the beginning of a symbol table entry. 

Note that the first symbol in the symbol table has an index of zero. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldtbread(3X), ldtbseek(3X), ldfcn(4). 
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NAME 

ldtbread — read an indexed symbol table entry of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <syms.h> 

#include <ldfcn.h> 

int ldtbread (ldptr, symindex, symbol) 

LDFILE »ldptr; 
long symindex; 

SYMENT ‘symbol; 

DESCRIPTION 

Ldtbread reads the symbol table entry specified by symindex of the common 
object file currently associated with ldptr into the area of memory beginning at 

symbol. 

Ldtbread returns SUCCESS or FAILURE. Ldtbread will fail if symindex is 
greater than the number of symbols in the object file, or if it cannot read the 
specified symbol table entry. 

Note that the first symbol in the symbol table has an index of zero. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldtbseek(3X), ldgetname(3X), ldfcn(4). 
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NAME 

ldtbseek — seek to the symbol table of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int ldtbseek (ldptr) 

LDFILE *ldptr; 

DESCRIPTION 

Ldtbseek seeks to the symbol table of the object file currently associated with 
ldptr. 

Ldtbseek returns SUCCESS or FAILURE. Ldtbseek will fail if the symbol table 
has been stripped from the object file, or if it cannot seek to the symbol table. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldtbread(3X), ldfcn(4). 
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NAME 

logname — return login name of user 

SYNOPSIS 

char *logname( ) 

DESCRIPTION 

Logname returns a pointer to the null-terminated login name; it extracts the 
SLOGNAME variable from the user’s environment. 

This routine is kept in /lib/libPW.a. 

FILES 

/etc/ profile 

SEE ALSO 

profile(4), environ(5). 

env(l), login (1) in the UNIX System V User Reference Manual. 

BUGS 

The return values point to static data whose content is overwritten by each call. 
This method of determining a login name is subject to forgery. 
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NAME 

malloc, free, realloc, calloc, mallopt, mallinfo — fast main memory allocator 

SYNOPSIS 

#include <malloc.h> 

char *malloc (size) 
unsigned size; 

void free (ptr) 
char *ptr; 

char *realloc (ptr, size) 
char »ptr; 
unsigned size; 

char ♦ calloc (nelem, elsize) 
unsigned nelem, elsize; 

int mallopt (cmd, value) 
int cmd, value; 

struct mallinfo mallinfo (max) 
int max; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package, 
which runs considerably faster than the malloc (.30 package. It is found in the 
library “malloc”, and is loaded if the option lmalloc” is used with cc( 1) or 

W(l). 

Malloc returns a pointer to a block of at least size bytes suitably aligned for 
any use. 

The argument to free is a pointer to a block previously allocated by malloc ; 
after free is performed this space is made available for further allocation, and 
its contents have been destroyed (but see mallopt below for a way to change 
this behavior). 

Undefined results will occur if the space assigned by malloc is overrun or if 
some random number is handed to free. 

Realloc changes the size of the block pointed to by ptr to size bytes and 
returns a pointer to the (possibly moved) block. The contents will be 
unchanged up to the lesser of the new and old sizes. 

Calloc allocates space for an array of nelem elements of size elsize. The space 
is initialized to zeros. 

Mallopt provides for control over the allocation algorithm. The available 
values for cmd are: 


M MXFAST 


M NLBLKS 


M GRAIN 


Set maxfast to value. The algorithm allocates all blocks below 
the size of maxfast in large groups and then doles them out 
very quickly. The default value for maxfast is 0. 

Set numlblks to value. The above mentioned “large groups” 
each contain numlblks blocks. Numlblks must be greater than 
0. The default value for numlblks is 100. 

Set grain to value. The sizes of all blocks smaller than max- 
fast are considered to be rounded up to the nearest multiple of 
grain. Grain must be greater than 0. The default value of 
grain is the smallest number of bytes which will allow align- 
ment of any data type. Value will be rounded up to a multiple 
of the default when grain is set. 
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MKEEP Preserve data in a freed block until the next malloc, realloc, 

or calloc. This option is provided only for compatibility with 
the old version of malloc and is not recommended. 

These values are defined in the <malloc.h> header file. 

Mallopt may be called repeatedly, but may not be called after the first small 
block is allocated. 


Mallinfo provides instrumentation describing space usage. It returns the struc- 
ture: 


struct mallinfo { 


int arena; 

/* 

int ordblks; 

/* 

int smblks; 

/* 

int hblkhd; 

/* 

int hblks; 

/* 

int usmblks; 

/* 

int fsmblks; 

/* 

int uordblks; 

/* 

int fordblks; 

/* 

int keepcost; 

/* 


/* 


total space in arena */ 
number of ordinary blocks */ 
number of small blocks */ 
space in holding block headers */ 
number of holding blocks */ 
space in small blocks in use */ 
space in free small blocks */ 
space in ordinary blocks in use */ 
space in free ordinary blocks */ 
space penalty if keep option */ 
is used */ 


This structure is defined in the <malloc.h> header file. 

Each of the allocation routines returns a pointer to space suitably aligned (after 
possible pointer coercion) for storage of any type of object. 

SEE ALSO 

brk(2), malloc(3C). 

DIAGNOSTICS 

Malloc, realloc and calloc return a NULL pointer if there is not enough avail- 
able memory. When realloc returns NULL, the block pointed to by ptr is left 
intact. If mallopt is called after any allocation or if cmd or value are invalid, 
non-zero is returned. Otherwise, it returns zero. 

WARNINGS 

This package usually uses more data space than malloc ( 3C). 

The code size is also bigger than malloc (3C) . 

Note that unlike malloc 1 3C), this package does not preserve the contents of a 
block when it is freed, unless the M KEEP option of mallopt is used. 
Undocumented features of malloc{iC) have not been duplicated. 
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NAME 

plot — graphics interface subroutines 

SYNOPSIS 

openpl 0 

erase 0 

label (s) 
char »s; 

line (xl, yl, x2, y2) 
int xl, yl, x2, y2; 

circle (x, y, r) 
int x, y, r; 

arc (x, y, xO, yO, xl, yl) 
int x, y, xO, yO, xl, yl; 

move (x, y) 
int x, y; 

cont (x, y) 
int x, y; 

point (x, y) 
int x, y; 

linemod (s) 
char *s; 

space (xO, yO, xl, yl) 
int xO, yO, xl, yl; 

closepl 0 
DESCRIPTION 

These subroutines generate graphic output in a relatively device-independent 
manner. Space must be used before any of these functions to declare the 
amount of space necessary. See plot {.A). Openpl must be used before any of 
the others to open the device for writing. Closepl flushes the output. 

Circle draws a circle of radius r with center at the point (x, y). 

Arc draws an arc of a circle with center at the point 6c, y) between the points 
(xO, yO) and (xl, yl). 

String arguments to label and linemod are terminated by nulls and do not con- 
tain new-lines. 

See plot (4) for a description of the effect of the remaining functions. 

The library files listed below provide several flavors of these routines. 

FILES 

/usr/lib/libplot.a produces output for tploti 1G) filters 

/usr/lib/lib300.a for DASI 300 

/usr/lib/lib300s.a for DASI 300s 

/usr/lib/lib450.a for DASI 450 

/ usr/lib/lib40 1 4.a for TEKTRONIX 40 1 4 


- 1 - 



PLOT(3X) 


PLOT(3X) 


WARNINGS 

In order to compile a program containing these functions in file.c it is necessary 
to use “cc file.c — lplot”. 

In order to execute it, it is necessary to use “a.out | tplot”. 

The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 

SEE ALSO 

plot (4). 

graph (1G), stat(lG), tplot (1G) in the UNIX System V User Reference Manual. 
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NAME 

regcmp, regex — compile and execute regular expression 
SYNOPSIS 

char *regcmp (stringl [, string2, ...1, (char *)0) 
char »stringl, *string2, 

char »regex (re, subject!, retO, ...]) 
char *re, ‘subject, *retO, 

extern char • loci; 

DESCRIPTION 

Regcmp compiles a regular expression and returns a pointer to the compiled 
form. M alloc {. 3C) is used to create space for the vector. It is the user’s 
responsibility to free unneeded space so allocated. A NULL return from 
regcmp indicates an incorrect argument. Regcmp ( 1) has been written to gen- 
erally preclude the need for this routine at execution time. 

Regex executes a compiled pattern against the subject string. Additional argu- 
ments are passed to receive values back. Regex returns NULL on failure or a 
pointer to the next unmatched character on success. A global character pointer 
loci points to where the match began. Regcmp and regex were mostly bor- 
rowed from the editor, ed( 1); however, the syntax and semantics have been 
changed slightly. The following are the valid symbols and their associated 
meanings. 

11*.'' These symbols retain their current meaning. 

$ Matches the end of the string; \n matches a new-line. 

— Within brackets the minus means through. For example, la-zl is 

equivalent to [abcd...xyzl. The — can appear as itself only if used as 
the first or last character. For example, the character class expression 
U-] matches the characters 1 and -. 

+ A regular expression followed by + means one or more times. For 

example, [0—91+ is equivalent to (0—9110—91*. 

(m) {m,} {m,u} 

Integer values enclosed in {} indicate the number of times the preced- 
ing regular expression is to be applied. The value m is the minimum 
number and u is a number, less than 256, which is the maximum. If 
only m is present (e.g., {m}), it indicates the exact number of times 
the regular expression is to be applied. The value (m,) is analogous to 
(m,infinity). The plus (+) and star (*) operations are equivalent to 
{ 1 ,} and {0,} respectively. 

( ... )$« 

The value of the enclosed regular expression is to be returned. The 
value will be stored in the (n+l)t h argument following the subject 
argument. At most ten enclosed regular expressions are allowed. 
Regex makes its assignments unconditionally. 

( ... ) Parentheses are used for grouping. An operator, e.g., *, +, {}, can 
work on a single character or a regular expression enclosed in 
parentheses. For example, (a*(cb+)*)$0. 

By necessity, all the above defined symbols are special. They must, therefore, 
be escaped to be used as themselves. 


- 1 - 



REGCMP (3X) 


REGCMP(3X) 


EXAMPLES 

Example 1: 

char *cursor, ‘newcursor, *ptr; 

newcursor = regex ((ptr = regcmp("~\n", 0)), cursor); 
free(ptr); 

This example will match a leading new-line in the subject string pointed at by 
cursor. 

Example 2: 

char ret0[9]; 

char ‘newcursor, ‘name; 

name = regcmp("([A— Za— z][A— za— zO— 9_] {0,7}) $0", 0); 
newcursor = regex(name, "123Testing321", retO); 

This example will match through the string “Testing3” and will return the 
address of the character after the last matched character (cursor+11). The 
string “Testing3” will be copied to the character array retO. 

Example 3: 

#include "file.i" 

char ‘string, ‘newcursor; 

newcursor = regex (name, string); 

This example applies a precompiled regular expression in file.i (see regcmp ( 1 ) ) 
against string. 

This routine is kept in /lib/libPW.a. 

SEE ALSO 

malloc(3C). 

ed(l), regcmp(l) in the UNIX System V User Reference Manual. 

BUGS 

The user program may run out of memory if regcmp is called iteratively 
without freeing the vectors no longer required. The following user-supplied 
replacement for malloci 3C) reuses the same vector saving time and space: 

/» user’s program */ 

char * 
malloc(n) 
unsigned n; 

{ 

static char rebuf[5 12]; 

return (n <= sizeof rebuf) ? rebuf : NULL; 

) 


- 2 - 



SPUTL (3X) 


SPUTL (3X) 


NAME 

sputl, sgetl — access long integer data in a machine-independent fashion. 
SYNOPSIS 

void sputl (value, buffer) 
long value; 
char ‘buffer; 

long sgetl (buffer) 
char *bufTer; 

DESCRIPTION 

Sputl takes the four bytes of the long integer value and places them in memory 
starting at the address pointed to by buffer. The ordering of the bytes is the 
same across all machines. 

Sgetl retrieves the four bytes in memory starting at the address pointed to by 
buffer and returns the long integer value in the byte ordering of the host 
machine. 

The combination of sputl and sgetl provides a machine-independent way of 
storing long numeric data in a file in binary form without conversion to charac- 
ters. 

A program which uses these functions must be loaded with the object-file 
access routine library libld.a. 
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NAME 

vprintf, vfprintf, vsprintf — print formatted output of a varargs argument list 

SYNOPSIS 

#include <stdio.h> 

#include <varargs.h> 

int vprintf (format, ap) 
char 'format; 
vajist ap; 

int vfprintf (stream, format, ap) 

FILE 'stream; 
char 'format; 
vajist ap; 

int vsprintf (s, format, ap) 
char 's, 'format; 
va list ap; 

DESCRIPTION 

vprintf , vfprintf , and vsprintf are the same as printf , fprintf, and sprintf 
respectively, except that instead of being called with a variable number of argu- 
ments, they are called with an argument list as defined by varargs (5). 

EXAMPLE 

The following demonstrates how vfprintf could be used to write an error rou- 
tine. 

#include <stdio.h> 

#include <varargs.h> 


/» 

* error should be called like 

* error(function_name, format, argl, arg2...); 

*/ 

/♦VARARGSO'/ 

void 

error (vaalist) 

/» Note that the functionname and format arguments cannot be 
' separately declared because of the definition of varargs. 

*/ 

vadcl 

{ 

vajist args; 
char »fmt; 

va_start(args); 

/» print out name of function causing error */ 
(void)fprintf(stderr, "ERROR in %s: ", va_arg(args, char *)); 
fmt = va_arg(args, char *); 

/» print out remainder of message */ 

(void)vfprintf(fmt, args); 
va_end (args) ; 

(void) abort ( ); 

] 

SEE ALSO 

printf (3S), varargs (5). 
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NAME 

abort — terminate Fortran program 

SYNOPSIS 

call abort ( ) 

DESCRIPTION 

Abort terminates the program which calls it, closing all open files truncated to 
the current position of the file pointer. 

DIAGNOSTICS 

When invoked, abort prints “Fortran abort routine called” on the standard 
error output. 

SEE ALSO 

abort(3C). 
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NAME 

abs, iabs, dabs, cabs, zabs — Fortran absolute value 

SYNOPSIS 

integer il, \2 
real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 
double complex dxl, dx2 

r2 = abs(rl) 

i2 = iabs(il) 
i2 = abs(il) 

dp2 = dabs(dpl) 
dp2 = abs(dpl) 

cx2 = cabs(cxl) 
cx2 = abs(cxl) 

dx2 = zabs(dxl) 
dx2 = abs(dxl) 

DESCRIPTION 

Abs is the family of absolute value functions, labs returns the integer absolute 
value of its integer argument. Dabs returns the double-precision absolute value 
of its double-precision argument. Cabs returns the complex absolute value of 
its complex argument. Zabs returns the double-complex absolute value of its 
double-complex argument. The generic form abs returns the type of its argu- 
ment. 

SEE ALSO 

floor(3M). 
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NAME 

acos, dacos — Fortran arccosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = acos(rl) 

dp2 = dacos(dpl) 
dp2 = acos(dpl) 

DESCRIPTION 

Acos returns the real arccosine of its real argument. Dacos returns the 
double-precision arccosine of its double-precision argument. The generic form 
acos may be used with impunity as its argument will determine the type of the 
returned value. 

SEE ALSO 

trig(3M). 
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NAME 

aimag, dimag — Fortran imaginary part of complex argument 

SYNOPSIS 

real r 

complex cxr 
double precision dp 
double complex cxd 

r = aimag(cxr) 
dp = dimag (cxd) 

DESCRIPTION 

Aimag returns the imaginary part of its single-precision complex argument. 
Dimag returns the double-precision imaginary part of its double-complex argu- 
ment. 
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NAME 

aint, dint — Fortran integer part intrinsic function 
SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = aint(rl) 

dp2 = dint(dpl) 
dp2 = aint(dpl) 

DESCRIPTION 

Aint returns the truncated value of its real argument in a real. Dint returns 
the truncated value of its double-precision argument as a double-precision 
value. Aint may be used as a generic function name, returning either a real or 
double-precision value depending on the type of its argument. 
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NAME 

asin, dasin - Fortran arcsine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = asin(rl) 

dp2 = dasin(dpl) 
dp2 = asin(dpl) 

DESCRIPTION , 

Asin returns the real arcsine of its real argument. Dasin returns the double- 
precision arcsine of its double-precision argument. The generic form asin may 
be used with impunity as it derives its type from that of its argument. 

SEE ALSO 

trig(3M). 
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NAME 

atan, datan — Fortran arctangent intrinsic function 
SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = atan(rl) 

dp2 = datan(dpl) 
dp2 = atan(dpl) 

DESCRIPTION 

Atan returns the real arctangent of its real argument. Datan returns the 
double-precision arctangent of its double-precision argument. The generic form 
atan may be used with a double-precision argument returning a double- 
precision value. 

SEE ALSO 

trig(3M). 
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NAME 

atan2, datan2 — Fortran arctangent intrinsic function 

SYNOPSIS 

real rl, r2, r3 

double precision dpi, dp2, dp3 
r3 = atan2(rl, r2) 

dp3 = datan2(dpl, dp2) 
dp3 = atan2(dpl, dp2) 

DESCRIPTION 

Atan2 returns the arctangent of argl/arg2 as a real value. Datan2 returns the 
double-precision arctangent of its double-precision arguments. The generic 
form atan2 may be used with impunity with double-precision arguments. 

SEE ALSO 

trig(3M). 
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NAME 

and, or, xor, not, lshift, rshift — Fortran bitwise boolean functions 

SYNOPSIS 

integer i, j, k 
real a, b, c 

double precision dpi, dp2, dp3 

k = and(i, j) 
c = or (a, b) 
j = xor(i, a) 
j = not(i) 
k = lshift (i, j) 
k = rshift (i, j) 

DESCRIPTION 

The generic intrinsic boolean functions and , or and xor return the value of the 
binary operations on their arguments. Not is a unary operator returning the 
one’s complement of its argument. Lshift and rshift return the value of the 
first argument shifted left or right, respectively, the number of times specified 
by the second (integer) argument. 

The boolean functions are generic, that is, they are defined for all data types as 
arguments and return values. Where required, the compiler will generate 
appropriate type conversions. 

NOTE 

Although defined for all data types, use of boolean functions on any but integer 
data is bizarre and will probably result in unexpected consequences. 

BUGS 

The implementation of the shift functions may cause large shift values to 
deliver weird results. 
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NAME 

conjg, dconjg — Fortran complex conjugate intrinsic function 

SYNOPSIS 

complex cxl, cx2 
double complex dxl, dx2 

cx2 = conjg(cxl) 
dx2 = dconjg(dxl) 

DESCRIPTION 

Conjg returns the complex conjugate of its complex argument. Dconjg returns 
the double-complex conjugate of its double-complex argument. 
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NAME 

cos, dcos, ccos — Fortran cosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = cos(rl) 

dp2 = dcos(dpl) 
dp2 = cos(dpl) 

cx2 = ccos (cxl) 
cx2 = cos(cxl) 

DESCRIPTION 

Cos returns the real cosine of its real argument. Dcos returns the double- 
precision cosine of its double-precision argument. Ccos returns the complex 
cosine of its complex argument. The generic form cos may be used with 
impunity as its returned type is determined by that of its argument. 

SEE ALSO 

trig(3M). 
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NAME 

cosh, dcosh — Fortran hyperbolic cosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = cosh(rl) 

dp2 = dcosh(dpl) 
dp2 = cosh(dpl) 

DESCRIPTION 

Cosh returns the real hyperbolic cosine of its real argument. Dcosh returns the 
double-precision hyperbolic cosine of its double-precision argument. The gen- 
eric form cosh may be used to return the hyperbolic cosine in the type of its 
argument. 

SEE ALSO 

sinh(3M). 
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NAME 

dim, ddim, idim — positive difference intrinsic functions 
SYNOPSIS 

integer al,a2,a3 
a3 = idim(al,a2) 

real al,a2,a3 
a3 = dim(al,a2) 

double precision al,a2.,a3 
a3 = ddim(al,a2) 

DESCRIPTION 

These functions return: 

al-a2 if al > a2 
o if al <= a2 
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NAME 

dprod — double precision product intrinsic function 

SYNOPSIS 

real al,a2 
double precision a3 
a3 = dprod (al,a2) 

DESCRIPTION 

Dprod returns the double precision product of its real arguments. 
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NAME 

exp, dexp, cexp — Fortran exponential intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = exp(rl) 

dp2 = dexp(dpl) 
dp2 = exp(dpl) 

cx2 = clog (cxl) 
cx2 = exp(cxl) 

DESCRIPTION 

Exp returns the real exponential function e x of its real argument, Dexp 
returns the double-precision exponential function of its double-precision argu- 
ment. Cexp returns the complex exponential function of its complex argument. 
The generic function exp becomes a call to dexp or cexp as required, depend- 
ing on the type of its argument. 

SEE ALSO 

exp(3M). 
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NAME 

int, ifix, idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char — explicit For- 
tran type conversion 

SYNOPSIS 

integer i, j 
real r, s 

double precision dp, dq 
complex cx 
double complex dcx 
character * 1 ch 

i = int(r) 
i = int(dp) 
i = int(cx) 
i = int(dcx) 
i = ifix(r) 
i = idint(dp) 

r = real(i) 
r = real (dp) 
r = real(cx) 
r = real (dcx) 
r = float (i) 
r = sngl (dp) 

dp = dble(i) 
dp = dble(r) 
dp = dble(cx) 
dp = dble(dcx) 

cx = cmplx(i) 
cx = cmplx(i, j) 
cx = cmplx(r) 
cx = cmplx (r, s) 
cx = cmplx (dp) 
cx = cmplx (dp, dq) 
cx = cmplx (dcx) 

dcx = dcmplx(i) 
dcx = dcmplx(i, j) 
dcx = dcmplx (r) 
dcx = dcmplx (r, s) 
dcx = dcmplx(dp) 
dcx = dcmplx(dp, dq) 
dcx = dcmplx(cx) 

i = ichar (ch) 
ch = char(i) 

DESCRIPTION 

These functions perform conversion from one data type to another. 

The function int converts to integer form its real, double precision, complex, or 
double complex argument. If the argument is real or double precision, int 
returns the integer whose magnitude is the largest integer that does not exceed 
the magnitude of the argument and whose sign is the same as the sign of the 
argument (i.e. truncation). For complex types, the above rule is applied to the 
real part, ifix and idint convert only real and double precision arguments 
respectively. 
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The function real converts to real form an integer , double precision, complex, 
or double complex argument. If the argument is double precision or double 
complex, as much precision is kept as is possible. If the argument is one of the 
complex types, the real part is returned, float and sngl convert only integer and 
double precision arguments respectively. 

The function dble converts any integer, real, complex, or double complex argu- 
ment to double precision form. If the argument is of a complex type, the real 
part is returned. 

The function cmplx converts its integer, real, double precision, or double com- 
plex argument (s) to complex form. 

The function dcmplx converts to double complex form its integer, real, double 
precision, or complex argument(s). 

Either one or two arguments may be supplied to cmplx and dcmplx . If there is 
only one argument, it is taken as the real part of the complex type and an ima- 
ginary part of zero is supplied. If two arguments are supplied, the first is taken 
as the real part and the second as the imaginary part. 

The function ichar converts from a character to an integer depending on the 
character’s position in the collating sequence. 

The function char returns the character in the /th position in the processor col- 
lating sequence where / is the supplied argument. 

For a processor capable of representing n characters, 

ichar (char (0) = i for 0 < i < n, and 

char (ichar (ch)) = ch for any representable character ch. 
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NAME 

getarg — return Fortran command-line argument 

SYNOPSIS 

character«N c 
integer i 

getarg (i, c) 

DESCRIPTION 

Getarg returns the /'-th command-line argument of the current process. Thus, if 
a program were invoked via 

foo argl arg2 arg3 

getarg(2, c) would return the string “arg2” in the character variable c. 

SEE ALSO 

getopt(3C). 
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NAME 

getenv — return Fortran environment variable 

SYNOPSIS 

character»N c 

getenvCTMPDIR", c) 

DESCRIPTION 

Getenv returns the character-string value of the environment variable 
represented by its first argument into the character variable of its second argu- 
ment. If no such environment variable exists, all blanks will be returned. 

SEE ALSO 

getenv(3C), environ(5). 


- 1 - 



IARGC (3F) 


IARGC (3F) 


NAME 

iargc 

SYNOPSIS 

integer i 
i = iargcO 

DESCRIPTION 

The iargc function returns the number of command line arguments passed to 
the program. Thus, if a program were invoked via 

foo argl arg2 arg3 

iargcO would return “3”. 

SEE ALSO 

getarg(3F). 
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NAME 

index — return location of Fortran substring 

SYNOPSIS 

character»Nl chi 
character*N2 ch2 
integer i 

i = index (chi, ch2) 

DESCRIPTION 

Index returns the location of substring ch2 in string chi . The value returned is 
the position at which substring ch2 starts, or 0 is it is not present in string chi . 
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NAME 

len — return length of Fortran string 

SYNOPSIS 

character*N ch 
integer i 

i = Ien(ch) 

DESCRIPTION 

Len returns the length of string ch. 
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NAME 

log, alog, dlog, clog — Fortran natural logarithm intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = alog(rl) 
r2 = log(rl) 

dp2 = dlog(dpl) 
dp2 = log(dpl) 

cx2 = clog(cxl) 
cx2 = log(cxl) 

DESCRIPTION 

Alog returns the real natural logarithm of its real argument. Dlog returns the 
double-precision natural logarithm of its double-precision argument. Clog 
returns the complex logarithm of its complex argument. The generic function 
log becomes a call to alog, dlog, or clog depending on the type of its argu- 
ment. 

SEE ALSO 

exp(3M). 
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NAME 

log 10, aloglO, dloglO — Fortran common logarithm intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = aloglO(rl) 
r2 = loglO(rl) 

dp2 = dloglO(dpl) 
dp2 = loglO(dpl) 

DESCRIPTION 

AloglO returns the real common logarithm of its real argument. DloglO 
returns the double-precision common logarithm of its double-precision argu- 
ment. The generic function loglO becomes a call to aloglO or dloglO depend- 
ing on the type of its argument. 

SEE ALSO 

exp(3M). 
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NAME 

max, maxO, amaxO, maxi, amaxl, dmaxl — Fortran maximum-value functions 
SYNOPSIS 

integer i, j, k, 1 
real a, b, c, d 

double precision dpi, dp2, dp3 

I = max(i, j, k) 
c = max(a, b) 
dp = max(a, b, c) 
k = maxOCi, j) 
a = amaxOfi, j, k) 
i = maxi (a, b) 
d = amaxl (a, b, c) 
dp3 = dmaxl (dpi, dp2) 

DESCRIPTION 

The maximum-value functions return the largest of their arguments (of which 
there may be any number). Max is the generic form which can be used for all 
data types and takes its return type from that of its arguments (which must all 
be of the same type). MaxO returns the integer form of the maximum value of 
its integer arguments; amaxO, the real form of its integer arguments; maxi, 
the integer form of its real arguments; amaxl, the real form of its real argu- 
ments; and dmaxl , the double-precision form of its double-precision arguments. 
SEE ALSO 

min(3F). 
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NAME 

mclock — return Fortran time accounting 

SYNOPSIS 

integer i 

i - mclock ( ) 

DESCRIPTION 

Mclock returns time accounting information about the current process and its 
child processes. The value returned is the sum of the current process’s user time 
and the user and system times of all child processes. 

SEE ALSO 

times (2), clock(3C), system(3F). 
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NAME 

min, minO, aminO, mini, aminl, dminl — Fortran minimum-value functions 
SYNOPSIS 

integer i, j, k, I 
real a, b, c, d 

double precision dpi, dp2, dp3 

1 = min(i, j, k) 
c = min(a, b) 
dp = min (a, b, c) 
k = minO(i, j) 
a = aminOli, j, k) 
i = mini (a, b) 
d = aminl (a, b, c) 
dp3 = dminl (dpi, dp2) 

DESCRIPTION 

The minimum-value functions return the minimum of their arguments (of 
which there may be any number). Min is the generic form which can be used 
for all data types and takes its return type from that of its arguments (which 
must all be of the same type). MinO returns the integer form of the minimum 
value of its integer arguments; aminO, the real form of its integer arguments; 
mini, the integer form of its real arguments; aminl, the real form of its real 
arguments; and dminl, the double-precision form of its double-precision argu- 
ments. 

SEE ALSO 

max(3F). 
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NAME 

mod, amod, dmod — Fortran remaindering intrinsic functions 

SYNOPSIS 

integer i, j, k 
real rl, r2, r3 

double precision dpi, dp2, dp3 
k = mod(i, j) 

r3 = amod(rl, r2) 
r3 = mod(rl, r2) 

dp3 = dmodldpl, dp2) 
dp3 = mod (dp I, dp2) 

DESCRIPTION 

Mod returns the integer remainder of its first argument divided by its second 
argument. Amod and dmod return, respectively, the real and double-precision 
whole number remainder of the integer division of their two arguments. The 
generic version mod will return the data type of its arguments. 
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NAME 

irand, rand, srand — random number generator 

SYNOPSIS 

call srand (iseed) 

i = irand 0 
x = rand( ) 

DESCRIPTION 

Irand generates successive pseudo-random numbers in the range from 0 to 
2** 15-1. Rand generates pseudo-random numbers distributed in (0, 1.0). 
Srand uses its integer argument to re-initialize the seed for successive invoca- 
tions of irand and rand. 

SEE ALSO 

rand(3C). 
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NAME 

anint, dnint, nint, idnint — Fortran nearest integer functions 

SYNOPSIS 

integer i 
real rl, r2 

double precision dpi, dp2 

r2 = anint(rl) 
i = nint(rl) 

dp2 = anint(dpl) 
dp2 = dnint(dpl) 

i = nint(dpl) 
i = idnint(dpl) 

DESCRIPTION 

Anint returns the nearest whole real number to its real argument (i.e., 
int(a+0.5) if a > 0, int(a-0.5) otherwise). Dnint does the same for its 
double-precision argument. Nint returns the nearest integer to its real argu- 
ment. Idnint is the double-precision version. Anint is the generic form of 
anint and dnint , performing the same operation and returning the data type of 
its argument. Nint is also the generic form of idnint. 
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NAME 

sign, isign, dsign — Fortran transfer-of-sign intrinsic function 

SYNOPSIS 

integer i, j, k 
real rl, r2, r3 

double precision dpi, dp2, dp3 

k = isign (i, j) 
k = sign(i, j) 

r3 = signfrl, r2) 

dp3 = dsign (dpi, dp2) 
dp3 = sign(dpl, dp2) 

DESCRIPTION 

Isign returns the magnitude of its first argument with the sign of its second 
argument. Sign and dsign are its real and double-precision counterparts, 
respectively. The generic version is sign and will devolve to the appropriate 
type depending on its arguments. 
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NAME 

signal — specify Fortran action on receipt of a system signal 

SYNOPSIS 

integer i 

external integer intfnc 
call signal (i, intfnc) 

DESCRIPTION 

Signal allows a process to specify a function to be invoked upon receipt of a 
specific signal. The first argument specifies which fault or exception; the second 
argument the specific function to be invoked. 

SEE ALSO 

kill (2), signal (2). 
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NAME 

sin, dsin, csin — Fortran sine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = sin(rl) 

dp2 = dsin(dpl) 
dp2 = sin(dpl) 

cx2 = csin(cxl) 
cx2 = sin(cxl) 

DESCRIPTION 

Sin returns the real sine of its real argument. Dsin returns the double- 
precision sine of its double-precision argument. Csin returns the complex sine 
of its complex argument. The generic sin function becomes dsin or csin as 
required by argument type. 

SEE ALSO 

trig(3M). 
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NAME 

sinh, dsinh — Fortran hyperbolic sine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = sinh(rl) 

dp2 = dsinh(dpl) 
dp2 = sinh(dpl) 

DESCRIPTION 

Sinh returns the real hyperbolic sine of its real argument. Dsinh returns the 
double-precision hyperbolic sine of its double-precision argument. The generic 
form sinh may be used to return a double-precision value when given a 
double-precision argument. 

SEE ALSO 

sinh(3M). 
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NAME 

sqrt, dsqrt, csqrt — Fortran square root intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = sqrt(rl) 

dp2 = dsqrt(dpl) 
dp2 = sqrt(dpl) 

cx2 = csqrt(cxl) 
cx2 = sqrt(cxl) 

DESCRIPTION 

Sqrt returns the real square root of its real argument. Dsqrt returns the 
double-precision square root of its double-precision argument. Csqrt returns 
the complex square root of its complex argument. Sqrt, the generic form, will 
become dsqrt or csqrt as required by its argument type. 

SEE ALSO 

exp(3M). 
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NAME 

lge, lgt, lie, lit — string comparision intrinsic functions 
SYNOPSIS 

character*N al, a2 
logical 1 

1 = lge (al,a2) 

1 = lgt (al,a2) 

1 = lie (al,a2) 

1 = lit (al,a2) 

DESCRIPTION 

These functions return .TRUE, if the inequality holds and .FALSE, otherwise. 
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NAME 

system — issue a shell command from Fortran 

SYNOPSIS 

character*N c 

call system (c) 

DESCRIPTION 

System causes its character argument to be given to sHl) as input, as if the 
string had been typed at a terminal. The current process waits until the shell 
has completed. 

SEE ALSO 

exec(2), system(3S). 

sh(l) in the UNIX System V User Reference Manual. 
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NAME 

tan, dtan — Fortran tangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = tan(rl) 

dp2 = dtan(dpl) 
dp2 = tan(dpl) 

DESCRIPTION 

Tan returns the real tangent of its real argument. Dtan returns the double- 
precision tangent of its double-precision argument. The generic tan function 
becomes dtan as required with a double-precision argument. 

SEE ALSO 

trig(3M). 
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NAME 

tanh, dtanh — Fortran hyperbolic tangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
r2 = tanh(rl) 

dp2 = dtanh(dpl) 
dp2 = tanh(dpl) 

DESCRIPTION 

Tanh returns the real hyperbolic tangent of its real argument. Dtanh returns 
the double-precision hyperbolic tangent of its double-precision argument. The 
generic form tanh may be used to return a double-precision value given a 
double-precision argument. 

SEE ALSO 

sinh(3M). 
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NAME 

intro — introduction to file formats 
DESCRIPTION 

This section outlines the formats of various files. The C struct declarations for 
the file formats are given where applicable. Usually, these structures can be 
found in the directories /usr/include or /usr/include/sys. 

References of the type name (1M) refer to entries found in Section 1 of the 
UNIX System V Administrator Reference Manual. 
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NAME 

a. out — common assembler and link editor output 
DESCRIPTION 

The file name a.out is the output file from the assembler twO) and the link edi- 
tor ld{ 1). Both programs will make a.out executable if there were no errors in 
assembling or linking and no unresolved external references. 

A common object file consists of a file header, a UNIX system header, a table 
of section headers, relocation information, (optional) line numbers, and a sym- 
bol table. The order is given below. 

File header. 

UNIX system header. 

Section 1 header. 

Section n header. 

Section 1 data. 

Section n data. 

Section 1 relocation. 

Section n relocation. 

Section 1 line numbers. 

Section n line numbers. 

Symbol table. 

String table. 

The last four sections (relocation, line numbers, symbol table and string table) 
may be missing if the program was linked with the — s option of ld{\) or if the 
symbol table and relocation bits were removed by strip { 1). Also note that if 
there were no unresolved external references after linking, the relocation infor- 
mation will be absent. The string table exists only if necessary. 

The sizes of each segment (contained in the header, discussed below) are in 
bytes and are even. 

When an a.out file is loaded into memory for execution, three logical segments 
are set up: the text segment, the data segment (initialized data followed by 
uninitialized, the latter actually being initialized to all 0’s), and a stack. The 
text segment begins at location 0 in the core image. The header is never 
loaded. If the magic number (the first field in the UNIX system header) is 407 
(octal), it indicates that the text segment is not to be write-protected or shared, 
so the data segment will be contiguous with the text segment. If the magic 
number is 410 (octal), the data segment and the text segment are not writable 
by the program; if other processes are executing the same a.out file, the 
processes will share a single text segment. 

On the 3B 20 computer, the stack begins at the end of the data section and 
grows towards higher addresses. On the 3B 5 computer the stack begins at 
location 0xc0020000 and grows toward higher addresses. The maximum stack 
size on the 3B 5 computer is 512K. On the VAX, the stack begins at the end of 
memory and grows towards lower addresses. The stack is automatically 
extended as required. The data segment is extended only as requested by the 
brk( 2) system call. 

The value of a word in the text or data portions that is not a reference to an 
undefined external symbol is exactly the value that will appear in memory when 
the file is executed. If a word in the text involves a reference to an undefined 
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external symbol, the storage class of the symbol-table entry for that word will 
be marked as an “external symbol”, and the section number will be set to 0. 
When the file is processed by the link editor and the external symbol becomes 
defined, the value of the symbol will be added to the word in the file. 

File Header 

The format of the filehdr header is 
struct filehdr 


unsigned short 

f_magic; 

h 

unsigned short 

fnscns; 

h 

long 

f_timdat; 

/* 

long 

f_symptr; 

/* 

long 

fnsyms; 

/* 

unsigned short 

fopthdr; 

/» 

unsigned short 

fflags; 

h 


magic number */ 
number of sections */ 
time and date stamp */ 
file ptr to symtab »/ 

# symtab entries */ 
sizeof(opt hdr) */ 
flags */ 


UNIX System Header 

The format of the VAX UNIX system header is 


typedef struct aouthdr 


short 

magic; 

/* magic number */ 

short 

vstamp; 

/« version stamp */ 

long 

tsize; 

/* text size in bytes, padded */ 

long 

dsize; 

/* initialized data (.data) «/ 

long 

bsize; 

/* uninitialized data (.bss) */ 

long 

entry; 

/* entry point */ 

long 

text_start; 

/* base of text used for this file */ 

long 

data_start; 

/» base of data used for this file */ 


} AOUTHDR; 


The format of the 3B 20 computer UNIX system header is 
typedef struct aouthdr 
{ 


short 

magic; 

/* magic number */ 

short 

vstamp; 

/» version stamp */ 

long 

tsize; 

/* text size in bytes, padded */ 

long 

dsize; 

/* initialized data (.data) */ 

long 

bsize; 

/» uninitialized data (.bss) */ 

long 

duml; 

/* unused fill space included »/ 

long 

dum2; 

/* for historical reasons */ 

long 

entry; 

/« entry point */ 

long 

textstart; 

/* base of text used for this file 

long 

datastart; 

/* base of data used for this file 


} AOUTHDR; 
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Section Header 

The format of the section header is 

struct scnhdr 

{ 

char 
long 
long 
long 
long 
long 
long 

unsigned short 
unsigned short 
long 

}; 

Relocation 

Object files have one relocation entry for each relocatable reference in the text 
or data. If relocation information is present, it will be in the following format: 


r_vaddr; /» (virtual) address of reference */ 
r_symndx; /* index into symbol table */ 
r_type; /* relocation type *1 

The start of the relocation information is srelptr from the section header. If 
there is no relocation information, s relptr is 0. 


struct reloc 

f 

long 

long 

short 


s_name[SYMNMLEN];/* section name */ 
s_paddr; /* physical address */ 
s vaddr; /* virtual address »/ 

s_size; /* section size */ 

s scnptr; /* file ptr to raw data */ 

s relptr; /* file ptr to relocation */ 
sjnnoptr; /* file ptr to line numbers */ 
s nreloc; /* # reloc entries */ 

s_nlnno; /* # line number entries */ 

s_flags; /* flags »/ 
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Symbol Table 

The format of the symbol table header is 

#define SYMNMLEN 8 

#define FILNMLEN 14 

#define SYMESZ 18 /* the size of a SYMENT */ 


struct syment 

{ 

union /» all ways to get a symbol name */ 

char _n_name[SYMNMLEN]; /* name of symbol */ 

struct 


long 
long 
} _n_n; 
char 
} _n; 

unsigned long 
short 

unsigned short 

char 

char 

}; 


_n_zeroes; /* == OL if in string table «/ 
_n_offset; /* location in string table */ 

»_n_nptr[2]; /* allows overlaying */ 


n_value; 

nscnum; 

ntype; 

nsclass; 

nnumaux; 


/* value of symbol */ 

/* section number */ 

/* type and derived type */ 
/* storage class »/ 

/* number of aux entries */ 


#define n name 
#define n zeroes 
#define n_offset 
#define n_nptr 


n._ n _ na me 
n ._n_n ._n_zeroes 
n._n_n._n_offset 
n._n_nptr[l] 


Some symbols require more information than a single entry; they are followed 
by auxiliary entries that are the same size as a symbol entry. The format fol- 
lows. 
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union auxent { 
struct { 

long xtagndx; 
union { 

struct { 

unsigned short x lnno; 
unsigned short x_size; 

] xlnsz; 
long x_fsize; 

} x misc; 
union { 

struct { 

long xjnnoptr; 
long x_endndx; 

} x_fcn; 
struct { 

unsigned short xdimenfDIMNUM]; 

} x_ary; 

) xjcnary; 

unsigned short x_tvndx; 

} x_sym; 

struct { 

char x_fname[FILNMLEN]; 

} x_file; 

struct { 

long x_scnlen; 
unsigned short x_nreloc; 
unsigned short x_nlinno; 

} x scn; 

struct { 

long xtvfill; 

unsigned short x_tvlen; 
unsigned short x_tvran[2l; 

} x_tv; 

}; 

Indexes of symbol table entries begin at zero. The start of the symbol table is 
fjymptr (from the file header) bytes from the beginning of the file. If the 
symbol table is stripped, fjymptr is 0. The string table (if one exists) begins 
at f symptr + ( f tisyms * SYMESZ) bytes from the beginning of the file. 

SEE ALSO 

brk(2), filehdr(4), ldfcn(4), linenum(4), reloc(4), scnhdr(4), syms(4). 
as ( 1 ) , cc(l), Id (1 ) in the UNIX System V User Reference Manual. 
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NAME 

a. out — PDP-1 1 assembler and link editor output 
DESCRIPTION 

A.out is the output file of the assembler ay(l) and the link editor Id (l). Both 
programs will make a.out executable if there were no errors in assembling or 
linking and no unresolved external references. 

This file has four sections: a header, the program text and data segments, relo- 
cation information, and a symbol table (in that order). The last two sections 
may be missing if the program was linked with the -s option of Id (1) or if the 
symbol table and relocation bits were removed by strip( 1). Also note that if 
there were no unresolved external references after linking, the relocation infor- 
mation will be removed. 

The sizes of each segment (contained in the header, discussed below) are in 
bytes and are even. The size of the header is not included in any of the other 
sizes. 

When an a.out file is loaded into memory for execution, three logical segments 
are set up: the text segment, the data segment (initialized data followed by 
uninitialized, the latter actually being initialized to all O’s), and a stack. The 
text segment begins at location 0 in the core image; the header is not loaded. 
If the magic number (the first field in the header) is 407 (octal), it indicates 
that the text segment is not to be write-protected or shared, so the data seg- 
ment will be contiguous with the text segment. If the magic number is 410 
(octal), the data segment begins at the first 0 mod 8K-byte boundary following 
the text segment, and the text segment is not writable by the program. If other 
processes are executing the same a.out file, they will share a single text seg- 
ment. If the magic number is 411 (octal) the text segment is again pure 
(write-protected and shared) and, moreover, the instruction and data spaces are 
separated; the text and data segment both begin at location 0. See the PDP- 
11 170 Processor Handbook for restrictions that apply to this situation. 

The stack will occupy the highest possible locations in the core image: from 
177776 (octal) on the PDP-11 and growing downwards. The stack is automati- 
cally extended as required. The data segment is only extended as requested by 
the brk{ 2) system call. 

The start of the text segment in the a.out file is hsize; the start of the data seg- 
ment is hsize+S { (the size of the text), where hsize is 20 (octal) on the PDP- 
11 . 

The value of a word in the text or data portions that is not a reference to an 
undefined external symbol is exactly the value that will appear in memory when 
the file is executed. If a word in the text or data portion involves a reference to 
an undefined external symbol, as indicated by the relocation information (dis- 
cussed below) for that word, then the value of the word as stored in the file is 
an offset from the associated external symbol. When the file is processed by 
the link editor and the external symbol becomes defined, the value of the sym- 
bol will be added to the word in the file. 


- 1 - 



A. OUT (4) 


(PDP-1 1 only) 


A. OUT (4) 


Header— PDP-1 1 

The format of the a.out header for the PDP-1 1 is as follows: 
struct exec { 

short a magic; /* magic number */ 

unsigned a_text; /* size of text segment */ 

unsigned adata; /* size of data segment */ 

unsigned a_bss; /* size of bss segment */ 
unsigned a_syms; /* size of symbol table */ 
unsigned a_entry; /* entry point of program */ 
char aunused; 

char a_hitext; /» hi bits for large text spaces */ 

char a_flag; /* set if relocation info stripped */ 

char a_stamp; /» version stamp */ 

Relocation— PDP-1 1 

If relocation information is present, it amounts to two bytes per relocatable 
datum. There is no relocation information if the “suppress relocation” flag 
(a Jlag ) in the header is on. 

The format of the relocation data is: 

struct rjnfo ( 

int r_symbolnum:l 1, 
r_segment:3, 
r_pcrel:l; 

}; 

The r _pcrel field indicates, if on, that the reference is relative to the program 
counter (pc) register (e.g., clr x); if off, that the reference is to the actual sym- 
bol (e.g., clr *$x). 

The r segment field indicates the segment referred to by the text or data word 
associated with the relocation word: 

00 indicates the reference is absolute; 

02 indicates the reference is to the text segment; 

04 indicates the reference is to initialized data; 

06 indicates the reference is to bss (uninitialized data); 

10 indicates the reference is to an undefined external symbol. 

The field r jymbolnum contains a symbol number in the case of external refer- 
ences, and is unused otherwise. The first symbol is numbered 0, the second 1, 
etc. 

The start of the relocation information on the PDP-1 1 is: 
hsize+ajext +a_data 

Symbol Table— PDP-11 

The symbol table on the PDP-1 1 consists of entries of the form: 

struct nlist { 

char n_name[8]; 

int n_type; 

unsigned n value; 

); 
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The n name field contains the ASCII name of the symbol, null-padded. The 
njype field indicates the type of the symbol; the following values are possible: 

00 undefined symbol 

01 absolute symbol 

02 text segment symbol 

03 data segment symbol 

04 bss segment symbol 

37 file name symbol (produced by ld{ 0) 

40 undefined external symbol 

41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 

The start of the symbol table on the PDP-1 1 is: 

hsize+2 (a text +a_data ) 

if relocation information is present, and 

hsize+ajext + a data 
if it is not. 

If the type of a symbol on the PDP-l 1 is undefined external and the value field 
is non-zero, the symbol is interpreted by the link editor ld{ 1) as the name of a 
common region whose size is indicated by the value of the symbol. 

SEE ALSO 

as(l), Id ( 1 ) , nm(l), strip(l) in the UNIX System V User Reference Manual. 
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NAME 

acct — per-process accounting file format 
SYNOPSIS 

#include <sys/acct.h> 

DESCRIPTION 

Files produced as a result of calling acct (2) have records in the form defined by 
<sys/acct.h>, whose contents are: 

typedef ushort compt; /* "floating point" «/ 

/* 13-bit fraction, 3-bit exponent */ 

struct acct 

{ 

char ac_flag; /* Accounting flag */ 

char acjstat; /* Exit status */ 

ushort ac_uid; 
ushort ac _gid; 
dev_t actty; 

time t acbtime; /* Beginning time */ 

comp_t ac_utime; /* acctng user time in clock ticks */ 

comp t ac stime; /» acctng system time in clock ticks */ 

comp t ac etime; /» acctng elapsed time in clock ticks »/ 
comp t acmem; /» memory usage in clicks */ 

comp t acio; /* chars trnsfrd by read/write */ 

comp t acrw; /* number of block reads/writes */ 

char ac_comm[8]; /* command name */ 

}; 

extern struct acct acctbuf; 

extern struct inode *acctp; /* inode of accounting file */ 

#define AFORK 01 /* has executed fork, but no exec */ 

#define ASU 02 /* used super-user privileges */ 

#define ACCTF 0300 /* record type: 00 = acct */ 

In acjiag, the AFORK flag is turned on by each fork (2 ) and turned off by an 
exec (2) . The ac_comm field is inherited from the parent process and is reset 
by any exec. Each time the system charges the process with a clock tick, it 
also adds to ac mem the current process size, computed as follows: 

(data size) + (text size) / (number of in-core processes using text) 

The value of ac mem / (ac stime + ac utime) can be viewed as an approxima- 
tion to the mean process size, as modified by text-sharing. 
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The structure tacct.h, which resides with the source files of the accounting com- 
mands, represents the total accounting format used by the various accounting 
commands: 

/* 

* total accounting (for acct period), also for day 
*/ 

struct tacct { 


uid_t 


tauid; 

/* userid */ 

char 


ta_name[8]; 

/» login name */ 

float 


ta_cpu[2]; 

/* cum. cpu time, p/np (mins) */ 

float 


ta_kcore[2]; 

/* cum kcore-minutes, p/np »/ 

float 


ta_con[2]; 

/* cum. connect time, p/np, mins »/ 

float 


tadu; 

/* cum. disk usage */ 

long 


ta_pc; 

/» count of processes */ 

unsigned 

short 

ta_sc; 

/* count of login sessions */ 

unsigned 

short 

tadc; 

/* count of disk samples */ 

unsigned 

short 

ta_fee; 

/* fee for special services */ 


}; 

SEE ALSO 

acct (2), exec (2), fork (2). 

acct(lM) in the UNIX System V Administrator Reference Manual. 
acctcom(l) in the UNIX System V User Reference Manual. 

BUGS 

The ac mem value for a short-lived command gives little information about the 
actual size of the command, because ac_mem may be incremented while a 
different command (e.g., the shell) is being executed by the process. 
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NAME 

ar — common archive file format 
DESCRIPTION 

The archive command ar{\) is used to combine several files into one. Archives 
are used mainly as libraries to be searched by the link editor ld{ 1). 

Each archive begins with the archive magic string. 

#define ARMAG "!<arch>\n" /» magic string »/ 

#define SARMAG 8 /» length of magic string */ 

Each archive which contains common object files (see a. out (4)) includes an 
archive symbol table. This symbol table is used by the link editor ld( 1) to 
determine which archive members must be loaded during the link edit process. 
The archive symbol table (if it exists) is always the first file in the archive (but 
is never listed) and is automatically created and/or updated by ar. 

Following the archive magic string are the archive file members. Each file 
member is preceded by a file member header which is of the following format: 

#define ARFMAG "*\n" /* header trailer string */ 


struct ar 
( 

Jidr 

/* file member header */ 

l 

char 

ar_name[16]; 

/* 7* terminated file member name »/ 

char 

ardatet 1 2]; 

/* file member date */ 

char 

ar_uid[6]; 

/* file member user identification */ 

char 

ar j>id[6]; 

/* file member group identification »/ 

char 

ar_mode[8]; 

/* file member mode (octal) */ 

char 

arsizet 10]; 

/» file member size »/ 

char 

ar_fmag[2]; 

/* header trailer string */ 


}; 


All information in the file member headers is in printable ASCII. The numeric 
information contained in the headers is stored as decimal numbers (except for 
arjnode which is in octal). Thus, if the archive contains printable files, the 
archive itself is printable. 

The arjiame field is blank-padded and slash (/) terminated. The ardate field 
is the modification date of the file at the time of its insertion into the archive. 
Common format archives can be moved from system to system as long as the 
portable archive command ar( 1) is used. Conversion tools such as arcv ( 1 ) and 
convert { 1) exist to aid in the transportation of non-common format archives to 
this format. 

Each archive file member begins on an even byte boundary; a newline is 
inserted between files if necessary. Nevertheless the size given reflects the 
actual size of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 

If the archive symbol table exists, the first file in the archive has a zero length 
name (i.e., ar namelOl == ’/’). The contents of this file are as follows: 

• The number of symbols. Length: 4 bytes. 

• The array of offsets into the archive file. Length: 4 bytes * “the 
number of symbols”. 
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• The name string table. Length: arjize — (4 bytes * (“the number of 
symbols” + 1)). 

The number of symbols and the array of offsets are managed with sgetl and 
sputl. The string table contains exactly as many null terminated strings as 
there are elements in the offsets array. Each offset from the array is associated 
with the corresponding name from the string table (in order). The names in 
the string table are all the defined global symbols found in the common object 
files in the archive. Each offset is the location of the archive header for the 
associated symbol. 

SEE ALSO 

sputl(3X), a.out(4). 

ar(l), arcv(l), convert(l), ld(l), strip(l) in the UNIX System V User Refer- 
ence Manual. 

CAVEATS 

The common archive structure is not compatible between the PDP-11 and the 
IBM-370, due to the different file formats. See arcv( 1) and convert ( 1) to con- 
vert between machines. 

Strip (1) will remove all archive symbol entries from the header. The archive 
symbol entries must be restored via the ts option of the ar{ 1) command before 
the archive can be used with the link editor ld( 1). 
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NAME 

ar — archive file format 
DESCRIPTION 

The archive command ar is used to combine several files into one. Archives are 
used mainly as libraries to be searched by the link editor ld( 1). 

A file produced by ar has a magic number at the start, followed by the consti- 
tuent files, each preceded by a file header. The magic number is 
01 77545 (octal) (it was chosen to be unlikely to occur anywhere else). The 
header of each file is 26 bytes long: 

#define ARMAG 0177545 
struct ar hdr { 

char ar_name[14]; 
long ardate; 
char aruid; 
char ar_gid; 
int arjnode; 
long ar_size; 

}; 

Each file begins on a word boundary; a null byte is inserted between files if 
necessary. Nevertheless the size given reflects the actual size of the file 
exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 

SEE ALSO 

ar(l), ld(l) in the UNIX System V User Reference Manual. 
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NAME 

checklist — list of file systems processed by fsck 
DESCRIPTION 

Checklist resides in directory /etc and contains a list of, at most, 15 special file 
names. Each special file name is contained on a separate line and corresponds 
to a file system. Each file system will then be automatically processed by the 
fsck{ \ M) command. 

SEE ALSO 

fsck(lM) in the UNIX System V Administrator Reference Manual. 
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NAME 

core — format of core image file 
DESCRIPTION 

The UNIX system writes out a core image of a terminated process when any of 
various errors occur. See signal (. 2) for the list of reasons; the most common 
are memory violations, illegal instructions, bus errors, and user-generated quit 
signals. The core image is called core and is written in the process’s working 
directory (provided it can be; normal access controls apply). A process with an 
effective user ID different from the real user ID will not produce a core image. 

The first section of the core image is a copy of the system’s per-user data for 
the process, including the registers as they were at the time of the fault. The 
size of this section depends on the parameter usize, which is defined in 
/usr/include/sys/param.h. The remainder represents the actual contents of the 
user’s core area when the core image was written. If the text segment is read- 
only and shared, or separated from data space, it is not dumped. 

The format of the information in the first section is described by the user struc- 
ture of the system, defined in /usr/include/sys/user.h. The important stuff not 
detailed therein is the locations of the registers, which are outlined in 
/usr/include/sys/reg.h. 

SEE ALSO 

setuid(2), signal (2). 

crash(lM) in the UNIX System V Administrator Reference Manual. 
sdb(l) in the UNIX System V User Reference Manual. 
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NAME 

cpio — format of cpio archive 
DESCRIPTION 

The header structure, when the — c option of cpio(l) is not used, is: 

struct ( 

short h_magic, 

hdev; 

ushort hino, 

hmode, 
huid, 
h _jgid; 

short hnlink, 

hrdev, 
h_mtime[2], 
hnamesize, 
h_filesize[2]; 

char h nameth namesize rounded to word]; 

} Hdr; 

When the — c option is used, the header information is described by: 

sscanf(Chdr,"%6o%6o%6o%6o%6o%6o%6o%6o%l llo%6o%l llo%s", 
&Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, &Hdr.h_mode, 
&Hdr.h_uid, &Hdr.h_gid, &Hdr.h_nlink, &Hdr.h_rdev, 
&Longtime, &Hdr.h_namesize,&Longfile,Hdr.h_name); 

Longtime and Longfile are equivalent to Hdr.hmtime and Hdr.h Jilesize, 
respectively. The contents of each file are recorded in an element of the array 
of varying length structures, archive, together with other items describing the 
file. Every instance of h magic contains the constant 070707 (octal). The 
items h dev through hjntime have meanings explained in stat( 2). The length 
of the null-terminated path name hname, including the null byte, is given by 
hnamesize. 

The last record of the archive always contains the name TRAILER!!!. Special 
files, directories, and the trailer are recorded with h Jilesize equal to zero. 

SEE ALSO 

stat(2). 

cpio(l), find(l) in the UNIX System V User Reference Manual. 
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NAME 

dir — format of directories 
SYNOPSIS 

#include <sys/dir.h> 

DESCRIPTION 

A directory behaves exactly like an ordinary file, save that no user may write 
into a directory. The fact that a file is a directory is indicated by a bit in the 
flag word of its i-node entry (see fs( 4)). The structure of a directory entry as 
given in the include file is: 

#ifndef DIRSIZ 
#define DIRSIZ 14 
#endif 

struct direct 

{ 

ino_t d_ino; 

char dnametDIRSIZ]; 

}; 

By convention, the first two entries in each directory are for . and ... The first 
is an entry for the directory itself. The second is for the parent directory. The 
meaning of .. is modified for the root directory of the master file system; there 
is no parent, so .. has the same meaning as .. 

SEE ALSO 

fs(4). 
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NAME 

errfile — error-log file format 
DESCRIPTION 

When hardware errors are detected by the system, an error record is generated 
and passed to the error-logging daemon for recording in the error log for later 
analysis. The default error log is /usr/adm/errfile. 

The format of an error record depends on the type of error that was encoun- 
tered. Every record, however, has a header with the following format: 

struct errhdr { 


short 

etype; 

/* record type */ 

short 

e len; 

/* bytes in record (inc hdr) */ 

time_t 

etime; 

/* time of day */ 

int 

ecpu; 

/* proc recording error - 3B 20 A 

}; 


computer only */ 

The permissible record types are as follows: 

#define E_GOTS 

010 

/* start for UNIX System 



* Release 3.0*/ 

#define E GORT 

Oil 

/* start for UNIX system/RT */ 

#define E_STOP 

012 

/* stop */ 

#define E TCHG 

013 

/* time change */ 

#define E_CCHG 

014 

/* configuration change */ 

#define E BLK 

020 

/* block device error */ 

#define E STRAY 

030 

/* stray interrupt */ 

#define E PRTY 

031 

/* memory parity */ 

#define EPIO 

041 

/* 3B 20 computer programmed 



* I/O */ 

#define E IOP 

042 

/* 3B 20 computer I/O 



* processor */ 

#define E_NI 

0100 

/* NI20 error */ 

Some records in the error 

file are of 

an administrative nature. These include 

the startup record that is 

entered into the file when logging is activated, the 

stop record that is written 

i if the daemon is terminated “gracefully”, and the 

time-change record that is 

used to account for changes in the system’s time-of- 

day. These records have the following formats: 

struct estart { 



short 

e_cpu; 

/* CPU type */ 

struct utsname 

e_name; 

/* system names */ 

#ifndef u3b 



short 

e_mmr3; 

/* contents mem mgmt reg 3 */ 

long 

esyssize; 

/* 1 1 /70 system memory size */ 

short 

e_bconf; 

/* block dev configuration */ 

#endif 



#ifdef u3b 



int 

e_mmcnt; 

/* kbytes per array */ 


#endif 

}; 


#define eend errhdr /* record header «/ 
struct etimchg { 

time t e_ntime; /* new time */ 
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Stray interrupts cause a record with the following format to be logged: 

struct estray { 

#ifdef u3b 

uint e_saddr; /* stray loc or device addr */ 

#else 

physadr esaddr; / * stray loc or device addr »/ 

short e_sbacty; /* active block devices */ 

#endif 

}; 

Memory subsystem error on 3B 20 computer and VAX 11/70 processor cause 
the following record to be generated: 

struct eparity { 

#ifdef u3b 

int e_parreg[3l; /* 3B computer memory 

* registers »/ 

#else 

short e_parreg[4]; /* memory subsys registers */ 

#endif 

}; 

Memory subsystem errors on VAX- 11/780 processors cause the following record 
to be generated: 

struct ememory { 

int esbier; 

int ememcad; 

}; 

Error records for block devices have the following format: 

struct eblock { 

#ifdef u3b 


ushort 

e_num; 

/* device number */ 

struct iostat { 



long 

io_ops; 

/* number read/writes */ 

long 

io_misc; 

/* number "other" operations */ 

ushort 

iounlog; 

/» number unlogged errors »/ 

} 

estats; 


short 

ebflags; 

/« read/write, error, etc */ 

daddr_t 

ebnum; 

/* logical block number */ 

uint 

ebytes; 

/* number bytes to transfer */ 

union ptbl { 



int page[64]; 

/* page table entries */ 

union ptbl 

*pnext; 


} 

e_ptbl; 


struct ptbl 

ejstbl; 

/* page table for transfer */ 

uint 

e_voff; 

/» offset into page table */ 

uint 

estat 1 ; 

/* status word 1 */ 

uint 

e_stat2; 

/* status word 2 »/ 


#endif 
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#ifndef u3b 


dev_t 

e_dev; 

physadr 

eregloc; 

short 

e_bacty; 

struct iostat { 


long 

ioops; 

long 

io_misc; 

ushort 

io_unlog; 

) 

e_stats; 

short 

ebflags; 

short 

ecyloff; 

daddr_t 

ebnum; 

ushort 

ebytes; 

paddr_t 

e_memadd; 

ushort 

ertry; 

short 

enreg; 


#endif 
#ifdef vax 

struct mba regs { 
long mba csr; 
long mba cr; 
long mba sr; 
long mba_var; 
long mbavcr; 

) e_mba; 

#endif 

}; 


/* "true" major + minor dev no */ 
/* controller address */ 

/* other block I/O activity */ 

/* number read/writes »/ 

/» number "other" operations */ 

/* number unlogged errors */ 

/* read/write, error, etc */ 

/* logical dev start cyl */ 

/* logical block number */ 

/* number bytes to transfer •/ 

/* buffer memory address »/ 

/* number retries */ 

/» number device registers */ 


The following values are used in the ejjflags word: 


#define E WRITE 

0 

/* write operation */ 

#define E READ 

1 

/* read operation */ 

#define E NOIO 

02 

/•no I/O pending •/ 

#define E PHYS 

04 

/• physical I/O •/ 

#define E_MAP 

010 

/• Unibus map in use •/ 

#define E ERROR 

020 

/• I/O failed •/ 

following error records are for the 3B 20 computer only: 

struct epio { 
char 

e_chan; 

/• programmed I/O (pio) error 
/• which channel •/ 

char 

edev; 

/• which dev on channel •/ 

uint 

echstat; 

/• channel status */ 

uint 

} 

ecmd; 

/* pio command •/ 

struct eiop { 
char 

eunit; 

/* I/O processor (iop) error */ 
/• unit number •/ 

uint 

e_word0; 

/• iop report word */ 

uint 

eword 1 ; 

/• iop report word •/ 
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The “true” major device numbers that identify the failing device are as follows: 


Digital Equipment 

#define RKO 

0 

#define RPO 

1 

#define RFO 

2 

#define TMO 

3 

#define TOO 

4 

#define HPO 

5 

#define HTO 

6 

#define HSO 

7 

#define RLO 

8 

#define HP1 

9 

#define HP2 

10 

#define HP3 

11 

SEE ALSO 

errdemon(lM) in the UNIX 


AT&T Technologies 
#define DFCO 0 

#define IOPO 1 

#define MTO 2 


System V Administrator Reference Manual. 
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NAME 

filehdr — file header for common object files 

SYNOPSIS 

#include <filehdr.h> 

DESCRIPTION 

Every common object file begins with a 20-byte header. The following C struct 
declaration is used: 


struct filehdr 
( 



l 

unsigned short 

fjmagic ; 

/* magic number «/ 

unsigned short 

f nscns ; 

/* number of sections */ 

long 

f timdat ; 

/» time & date stamp */ 

long 

f symptr ; 

/* file ptr to symtab */ 

long 

f nsyms ; 

/* # symtab entries */ 

unsigned short 

f_opthdr ; 

/* sizeof(opt hdr) */ 

unsigned short 

f flags ; 

/* flags */ 


Fjymptr is the byte offset into the file at which the symbol table can be found. 
Its value can be used as the offset in fseek(3S ) to position an I/O stream to the 
symbol table. The UNIX system optional header is 36 bytes on the 3B 20 com- 
puter, 28 bytes otherwise. The valid magic numbers are given below: 

#define N3BMAGIC 0550 /« 3B 20 computer */ 

#define NTVMAGIC 0551 /* 3B 20 computer */ 


#define VAXWRMAGIC 0570 
#define VAXROMAGIC 0575 

The value in ftimdat is obtained from 


currently defined 

are: 



#define 

FRELFLG 

00001 

/* 

#define 

FEXEC 

00002 

/* 

#define 

FLNNO 

00004 

/* 

#define 

FLSYMS 

00010 

/* 

#define 

FMINMAL 

00020 

/* 

#define 

FUPDATE 

00040 

/* 

#define 

FSWABD 

00100 

/* 

#define 

FAR16WR 

00200 

/* 

#define 

FAR32WR 

00400 

/* 

#define 

FAR32W 

01000 

/* 

#define 

FPATCH 

02000 

/* 


SEE ALSO 

time(2), fseek(3S), a.out(4). 


/* VAX writable text segments «/ 

/* VAX readonly sharable text segments */ 

the time (2) system call. Flag bits 


relocation entries stripped */ 
file is executable */ 
line numbers stripped */ 
local symbols stripped »/ 
minimal object file */ 
update file, ogen produced */ 
file is "pre-swabbed" */ 

16 bit DEC host */ 

32 bit DEC host »/ 
non-DEC host */ 

"patch" list in opt hdr */ 
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NAME 

file system — format of system volume 
SYNOPSIS 

#include <sys/filsys.h> 

#include <sys/types.h> 

#include <sys/param.h> 

DESCRIPTION 

Every file system storage volume has a common format for certain vital infor- 
mation. Every such volume is divided into a certain number of 512-byte long 
sectors. Sector 0 is unused and is available to contain a bootstrap program or 
other information. 

Sector 1 is the super-block. The format of a super-block is: 

/* 


* Structure of the 

super-block 


*/ 




struct 

filsys 



I 

ushort 

sisize; 

/• size in blocks of i-list •/ 


daddrt 

s_fsize; 

/• size in blocks of entire volume */ 


short 

snfree; 

/* number of addresses in s free */ 


daddrt 

s_free[NICFREE]; 

/* free block list */ 


short 

sninode; 

/• number of i-nodes in s inode */ 


ino t 

sinodelNICINOD]; 

/* free i-node list */ 


char 

sflock; 

/* lock during free list manipulation */ 


char 

silock; 

/* lock during i-list manipulation ♦/ 


char 

s_fmod; 

/* super block modified flag */ 


char 

sronly; 

/* mounted read-only flag */ 


time_t 

s_time; 

/* last super block update */ 


short 

s_dinfo[4l; 

/* device information */ 


daddr_t 

sjfree; 

/* total free blocks*/ 


inot 

stinode; 

/* total free i-nodes */ 


char 

s_fname[6l; 

/* file system name */ 


char 

s_fpack[6l; 

/* file system pack name */ 


long 

s fill! 13]; 

/• ADJUST to make sizeof filsys be 512 •/ 


long 

smagic; 

/* magic number to denote new file system */ 

}; 

long 

sjype; 

/* type of new file system */ 

#define 

FsMAGIC 

0xfdl87e20 

/ * s_magic number */ 

#define 

Fslb 

1 

/* 512 byte block */ 

#define 

Fs2b 

2 

/* 1024 byte block */ 


Sjype indicates the file system type. Currently, two types of file systems are 
supported: the original 512-byte oriented and the new improved 1024-byte 
oriented. Sjnagic is used to distinguish the original 512-byte oriented file sys- 
tems from the newer file systems. If this field is not equal to the magic 
number, FsMAGIC, the type is assumed to be Fslb, otherwise the sjype field 
is used. In the following description, a block is then determined by the type. 
For the original 512-byte oriented file system, a block is 512 bytes. For the 
1024-byte oriented file system, a block is 1024 bytes or two sectors. The 
operating system takes care of all conversions from logical block numbers to 
physical sector numbers. 

Sisize is the address of the first data block after the i-list; the i-list starts just 
after the super-block, namely in block 2; thus the i-list is sjsize — 2 blocks long. 
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S Jsize is the first block not potentially available for allocation to a file. These 
numbers are used by the system to check for bad block numbers; if an “impos- 
sible” block number is allocated from the free list or is freed, a diagnostic is 
written on the on-line console. Moreover, the free array is cleared, so as to 
prevent further allocation from a presumably corrupted free list. 

The free list for each volume is maintained as follows. The s Jree array con- 
tains, in 5 Jree [1], . .., s Jree[s_nfree —\ ], up to 49 numbers of free blocks. 
S JreelO] is the block number of the head of a chain of blocks constituting the 
free list. The first long in each free-chain block is the number (up to 50) of 
free-block numbers listed in the next 50 longs of this chain member. The first 
of these 50 blocks is the link to the next member of the chain. To allocate a 
block: decrement sjifree, and the new block is s Jreelsjifree], If the new 
block number is 0, there are no blocks left, so give an error. If sjifree became 
0, read in the block named by the new block number, replace sjifree by its 
first word, and copy the block numbers in the next 50 longs into the sjree 
array. To free a block, check if sjifree is 50; if so, copy sjifree and the s Jree 
array into it, write it out, and set sjifree to 0. In any event set j Jreelsnfree] 
to the freed block’s number and increment sjifree. 

Sjfree is the total free blocks available in the file system. 

Sjiinode is the number of free i-numbers in the sjnode array. To allocate an 
i-node: if sjiinode is greater than 0, decrement it and return 
s inodels ninode ]. If it was 0, read the i-list and place the numbers of all free 
i-nodes (up to 100) into the sjnode array, then try again. To free an i-node, 
provided sjiinode is less than 100, place its number into sjnodels ninode] and 
increment s ninode. If s ninode is already 100, do not bother to enter the 
freed i-node into any table. This list of i-nodes is only to speed up the alloca- 
tion process; the information as to whether the i-node is really free or not is 
maintained in the i-node itself. 

Sjinode is the total free i-nodes available in the file system. 

5 Jock and sjlock are flags maintained in the core copy of the file system 
while it is mounted and their values on disk are immaterial. The value of 
s Jmod on disk is likewise immaterial; it is used as a flag to indicate that the 
super-block has changed and should be copied to the disk during the next 
periodic update of file system information. 

Sjonly is a read-only flag to indicate write-protection. 

Sjime is the last time the super-block of the file system was changed, and is 
the number of seconds that have elapsed since 00:00 Jan. 1, 1970 (GMT). 
During a reboot, the sjime of the super-block for the root file system is used to 
set the system’s idea of the time. 

S Jname is the name of the file system and s Jpack is the name of the pack. 

I-numbers begin at 1, and the storage for i-nodes begins in block 2. Also, i- 
nodes are 64 bytes long. I-node 1 is reserved for future use. I-node 2 is 
reserved for the root directory of the file system, but no other i-number has a 
built-in meaning. Each i-node represents one file. For the format of an i-node 
and its flags, see inode ( 4). 

FILES 

/ usr/include/ sys/filsys.h 
/ usr/include/sys/ stat.h 

SEE ALSO 

inode (4). 

fsck(lM), fsdb(lM), mkfs(lM) in the UNIX System V Administrator Refer- 
ence Manual. 
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NAME 

fspec — format specification in text files 
DESCRIPTION 

It is sometimes convenient to maintain text files on the UNIX system with non- 
standard tabs, (i.e., tabs which are not set at every eighth column). Such files 
must generally be converted to a standard format, frequently by replacing all 
tabs with the appropriate number of spaces, before they can be processed by 
UNIX system commands. A format specification occurring in the first line of a 
text file specifies how tabs are to be expanded in the remainder of the file. 

A format specification consists of a sequence of parameters separated by blanks 
and surrounded by the brackets <: and :>. Each parameter consists of a 
keyletter, possibly followed immediately by a value. The following parameters 
are recognized: 

t tabs The t parameter specifies the tab settings for the file. The value of 
tabs must be one of the following: 

1. a list of column numbers separated by commas, indicating 
tabs set at the specified columns; 

2. a — followed immediately by an integer n, indicating tabs at 
intervals of n columns; 

3. a — followed by the name of a “canned” tab specification. 

Standard tabs are specified by t— 8, or equivalently, tl,9,17,25,etc. 
The canned tabs which are recognized are defined by the tabs(l) 
command. 

s size The s parameter specifies a maximum line size. The value of size 

must be an integer. Size checking is performed after tabs have 
been expanded, but before the margin is prepended. 

m margin The m parameter specifies a number of spaces to be prepended to 
each line. The value of margin must be an integer. 

d The d parameter takes no value. Its presence indicates that the 

line containing the format specification is to be deleted from the 
converted file. 

e The e parameter takes no value. Its presence indicates that the 

current format is to prevail only until another format specification 
is encountered in the file. 

Default values, which are assumed for parameters not supplied, are t— 8 and 
mO. If the s parameter is not specified, no size checking is performed. If the 
first line of a file does not contain a format specification, the above defaults are 
assumed for the entire file. The following is an example of a line containing a 
format specification: 

* <:t5,10,15 s72:> * 

If a format specification can be disguised as a comment, it is not necessary to 
code the d parameter. 

Several UNIX system commands correctly interpret the format specification for 
a file. Among them is gath (see send (1C)) which may be used to convert files 
to a standard format acceptable to other UNIX system commands. 

SEE ALSO 

ed(l), newform(l), send (1C), tabs(l) in the UNIX System V User Reference 
Manual. 
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NAME 

gettydefs — speed and terminal settings used by getty 
DESCRIPTION 

The /etc/gettydefs file contains information used by gettyi 1M) to set up the 
speed and terminal settings for a line. It supplies information on what the 
login prompt should look like. It also supplies the speed to try next if the user 
indicates the current speed is not correct by typing a <break> character. 

Each entry in /etc/gettydefs has the following format: 

label# initial-flags # final-flags # login-prompt #next-label 

Each entry is followed by a blank line. The various fields can contain quoted 
characters of the form \b, \n, \c, etc., as well as \nnn, where nnn is the octal 
value of the desired character. The various fields are: 

This is the string against which getty tries to match its second 
argument. It is often the speed, such as 1200, at which the ter- 
minal is supposed to run, but it need not be (see below) . 

These flags are the initial ioctlil) settings to which the terminal 
is to be set if a terminal type is not specified to getty. The flags 
that getty understands are the same as the ones listed in 
/usr/include/sys/termio.h (see termio (7)). Normally only the 
speed flag is required in the initial-flags. Getty automatically 
sets the terminal to raw input mode and takes care of most of 
the other flags. The initial-flag settings remain in effect until 
getty executes login { 1). 

These flags take the same values as the initial-flags and are set 
just prior to getty executes login. The speed flag is again 
required. The composite flag SANE takes care of most of the 
other flags that need to be set so that the processor and terminal 
are communicating in a rational fashion. The other two com- 
monly specified final-flags are TAB3, so that tabs are sent to the 
terminal as spaces, and HUPCL, so that the line is hung up on 
the final close. 

login-prompt This entire field is printed as the login-prompt. Unlike the 
above fields where white space is ignored (a space, tab or new- 
line), they are included in the login-prompt field. 

next -label If this entry does not specify the desired speed, indicated by the 
user typing a <break> character, then getty will search for the 
entry with next-label as its label field and set up the terminal 
for those settings. Usually, a series of speeds are linked together 
in this fashion, into a closed set; For instance, 2400 linked to 
1200, which in turn is linked to 300, which finally is linked to 
2400. 

If getty is called without a second argument, then the first entry of 
/etc/gettydefs is used, thus making the first entry of /etc/gettydefs the default 
entry. It is also used if getty can not find the specified label. If /etc/gettydefs 
itself is missing, there is one entry built into the command which will bring up 
a terminal at 300 baud. 

It is strongly recommended that after making or modifying /etc/gettydefs, it be 
run through getty with the check option to be sure there are no errors. 


label 

initial-flags 


final -flags 
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FILES 

/etc/gettydefs 

SEE ALSO 

ioctl(2). 

getty(lM), termio(7) in the UNIX System V Administrator Reference Manual. 
login (1) in the UNIX System V User Reference Manual. 
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NAME 

gps - graphical primitive string, format of graphical files 

DESCRIPTION 

GPS is a format used to store graphical data. Several routines have been 
developed to edit and display GPS files on various devices. Also, higher level 
graphics programs such as plot (in ^ar(lG)) and vtoc (in toc(lG)) produce 
GPS format output files. 


A GPS is composed of five types of graphical data or primitives. 

GPS PRIMITIVES 

lines The lines primitive has a variable number of points from which zero 
or more connected line segments are produced. The first point 
given produces a move to that location. (A move is a relocation of 
the graphic cursor without drawing.) Successive points produce line 
segments from the previous point. Parameters are available to set 
color , weight , and style (see below). 

arc The arc primitive has a variable number of points to which a curve 

is fit. The first point produces a move to that point. If only two 
points are included, a line connecting the points will result; if three 
points a circular arc through the points is drawn; and if more than 
three, lines connect the points. (In the future, a spline will be fit to 
the points if they number greater than three.) Parameters are avail- 
able to set color, weight, and style. 

text The text primitive draws characters. It requires a single point 

which locates the center of the first character to be drawn. Param- 
eters are color , font, textsize, and textangle. 

hardware The hardware primitive draws hardware characters or gives control 
commands to a hardware device. A single point locates the begin- 
ning location of the hardware string. 

comment A comment is an integer string that is included in a GPS file but 
causes nothing to be displayed. All GPS files begin with a comment 
of zero length. 


GPS PARAMETERS 

color Color is an integer value set for arc, lines, and text primitives. 

weight Weight is an integer value set for arc and lines primitives to indi- 
cate line thickness. The value 0 is narrow weight, 1 is bold, and 2 
is medium weight. 


style 


font 


textsize 


Style is an integer value set for lines and arc primitives to give one 
of the five different line styles that can be drawn on TEKTRONIX 
4010 series storage tubes. They are: 

0 solid 

1 dotted 

2 dot dashed 

3 dashed 

4 long dashed 

An integer value set for text primitives to designate the text font to 
be used in drawing a character string. (Currently font is expressed 
as a four-bit weight value followed by a four-bit style value.) 

Textsize is an integer value used in text primitives to express the 
size of the characters to be drawn. Textsize represents the height 
of characters in absolute universe-units and is stored at one-fifth 
this value in the size-orientation Go) word (see below). 
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textangle Textangle is a signed integer value used in text primitives to express 
rotation of the character string around the beginning point. 
Textangle is expressed in degrees from the positive x-axis and can 
be a positive or negative value. It is stored in the size-orientation 
( 50 ) word as a value 256/360 of it’s absolute value. 


ORGANIZATION 

GPS primitives are organized internally as follows: 


lines 

arc 

text 

hardware 

comment 

cw 


point (s) 


sw 


so 

string 


cw points sw 

cw points sw 
cw point sw so [ string ] 
cw point [ string ] 
cw [string] 

Cw is the control word and begins all primitives. It consists of four 
bits that contain a primitive-type code and twelve bits that contain 
the word-count for that primitive. 

Pointis) is one or more pairs of integer coordinates. Text and 
hardware primitives only require a single point. Pointis ) are values 
within a Cartesian plane or universe having 64K (— 32K to +32K) 
points on each axis. 

Sw is the style-word and is used in lines, arc, and text primitives. 
For all three, eight bits contain color information. In arc and lines 
eight bits are divided as four bits weight and four bits style. In the 
text primitive eight bits of sw contain the font. 

So is the size-orientation word used in text primitives. Eight bits 
contain text size and eight bits contain text rotation. 

String is a null-terminated character string. If the string does not 
end on a word boundary, an additional null is added to the GPS file 
to insure word-boundary alignment. 


SEE ALSO 

graphics (1G), stat(lG), toc(lG) in the UNIX System V User Reference 
Manual. 
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NAME 

group — group file 
DESCRIPTION 

Group contains for each group the following information: 

group name 
encrypted password 
numerical group ID 

comma-separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; each group is 
separated from the next by a new-line. If the password field is null, no pass- 
word is demanded. 

This file resides in directory /etc. Because of the encrypted passwords, it can 
and does have general read permission and can be used, for example, to map 
numerical group ID’s to names. 

FILES 

/etc/group 
SEE ALSO 

crypt (3C), passwd(4). 

newgrp(l), passwd(l) in the UNIX System V User Reference Manual. 
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NAME 

inittab — script for the init process 
DESCRIPTION 

The inittab file supplies the script to init' s role as a general process dispatcher. 
The process that constitutes the majority of init’ s process dispatching activities 
is the line process /etc/getty that initiates individual terminal lines. Other 
processes typically dispatched by init are daemons and the shell. 

The inittab file is composed of entries that are position dependent and have the 
following format: 

id:rstate:action:process 

Each entry is delimited by a newline, however, a backslash (\) preceding a 
newline indicates a continuation of the entry. Up to 512 characters per entry 
are permitted. Comments may be inserted in the process field using the .sMl) 
convention for comments. Comments for lines that spawn gettys are displayed 
by the who( 1) command. It is expected that they will contain some informa- 
tion about the line such as the location. There are no limits (other than max- 
imum entry size) imposed on the number of entries within the inittab file. The 
entry fields are: 

id This is one or two characters used to uniquely identify an entry. 

estate This defines the run-level in which this entry is to be processed. 

Run-levels effectively correspond to a configuration of processes in the 
system. That is, each process spawned by init is assigned a run-level 
or run-levels in which it is allowed to exist. The run-levels are 
represented by a number ranging from 0 through 6. As an example, 
if the system is in run-level 1 , only those entries having a 1 in the 
estate field will be processed. When init is requested to change run- 
levels, all processes which do not have an entry in the rstate field for 
the target run-level will be sent the warning signal (SIGTERM) and 
allowed a 20-second grace period before being forcibly terminated by 
a kill signal (SIGKILL). The rstate field can define multiple run- 
levels for a process by selecting more than one run-level in any com- 
bination from 0—6. If no run-level is specified, then the process is 
assumed to be valid at all run-levels 0—6. There are three other 
values, a, b and c, which can appear in the rstate field, even though 
they are not true run-levels. Entries which have these characters in 
the rstate field are processed only when the telinit (see inif(lM)) pro- 
cess requests them to be run (regardless of the current run-level of 
the system). They differ from run-levels in that init can never enter 
run-level a, b or c. Also, a request for the execution of any of these 
processes does not change the current run-level. Furthermore, a pro- 
cess started by an a, b or c command is not killed when init changes 
levels. They are only killed if their line in /etc/inittab is marked off 
in the action field, their line is deleted entirely from /etc/inittab, or 
init goes into the SINGLE USER state. 

action Key words in this field tell init how to treat the process specified in 
the process field. The actions recognized by init are as follows: 

respawn If the process does not exist then start the process, do not 
wait for its termination (continue scanning the inittab 
file), and when it dies restart the process. If the process 
currently exists then do nothing and continue scanning 
the inittab file. 


- 1 - 



INITTAB(4) 


INITTAB (4) 


wait 

once 

boot 

bootwait 

powerfail 

powerwait 

off 

ondemand 

initdefault 


Upon init’ s entering the run-level that matches the 
entry’s r state, start the process and wait for its termina- 
tion. All subsequent reads of the inittab file while init is 
in the same run-level will cause init to ignore this entry. 

Upon init' s entering a run-level that matches the entry’s 
r state, start the process, do not wait for its termination. 
When it dies, do not restart the process. If upon entering 
a new run-level, where the process is still running from a 
previous run-level change, the program will not be res- 
tarted. 

The entry is to be processed only at init’ s boot-time read 
of the inittab file. Init is to start the process, not wait for 
its termination; and when it dies, not restart the process. 
In order for this instruction to be meaningful, the rstate 
should be the default or it must match init’ s run-level at 
boot time. This action is useful for an initialization func- 
tion following a hardware reboot of the system. 

The entry is to be processed only at init' s boot-time read 
of the inittab file. Init is to start the process, wait for its 
termination and, when it dies, not restart the process. 

Execute the process associated with this entry only when 
init receives a power fail signal (SIGPWR see signal (2)). 

Execute the process associated with this entry only when 
init receives a power fail signal (SIGPWR) and wait until 
it terminates before continuing any processing of inittab. 

If the process associated with this entry is currently run- 
ning, send the warning signal (SIGTERM) and wait 20 
seconds before forcibly terminating the process via the kill 
signal (SIGKILL). If the process is nonexistent, ignore the 
entry. 

This instruction is really a synonym for the respawn 
action. It is functionally identical to respawn but is given 
a different keyword in order to divorce its association with 
run- levels. This is used only with the a, b or c values 
described in the rstate field. 

An entry with this action is only scanned when init ini- 
tially invoked. Init uses this entry, if it exists, to deter- 
mine which run-level to enter initially. It does this by 
taking the highest run-level specified in the rstate field 
and using that as its initial state. If the rstate field is 
empty, this is interpreted as 0123456 and so init will 
enter run-level 6. Also, the initdefault entry cannot 
specify that init start in the SINGLE USER state. Addi- 
tionally, if init does not find an initdefault entry in 
/etc/inittab, then it will request an initial run-level from 
the user at reboot time. 
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sysinit Entries of this type are executed before init tries to access 
the console. It is expected that this entry will be only 
used to initialize devices on which init might try to ask 
the run-level question. These entries are executed and 
waited for before continuing. 

process This is a sh command to be executed. The entire process field is 
prefixed with exec and passed to a forked sh as sh — c 'exec com- 
mand'. For this reason, any legal sh syntax can appear in the process 
field. Comments can be inserted with the ; #comment syntax. 

FILES 

/etc/inittab 
SEE ALSO 

exec (2), open (2), signal (2). 

getty(lM), init(lM) in the UNIX System V Administrator Reference Manual. 

sh(l), who(l) in the UNIX System V User Reference Manual. 
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NAME 

inode — format of an i-node 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ino.h> 

DESCRIPTION 

An i-node for a plain file or directory in a file system has the following struc- 
ture defined by <sys/ino.h>. 

/* Inode structure as it appears on a disk block. */ 


struct dinode 
( 



l 

ushort 

dijnode; 

/» mode and type of file */ 

short 

dinlink; 

/* number of links to file */ 

ushort 

di_uid; 

/* owner’s user id */ 

ushort 

di_gid; 

/* owner’s group id */ 

oflfj 

disize; 

/* number of bytes in file */ 

char 

di_addr[40]; 

/* disk block addresses */ 

time_t 

diatime; 

/* time last accessed »/ 

timet 

dimtime; 

/* time last modified */ 

timet 

di_ctime; 

/* time of last file status change */ 


J > 

/* 

* the 40 address bytes: 

* 39 used; 13 addresses 

* of 3 bytes each. 

*/ 

For the meaning of the defined types offj and timej see types (5) . 

FILES 

/ usr/include/sys/ino.h 
SEE ALSO 

stat(2), fs(4), types(5). 
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NAME 

issue — issue identification file 
DESCRIPTION 

The file /etc/issue contains the issue or project identification to be printed as a 
login prompt. This is an ASCII file which is read by program getty and then 
written to any terminal spawned or respawned from the lines file. 

FILES 

/ etc/issue 
SEE ALSO 

login(l) in the UNIX System V User Reference Manual. 
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NAME 

ldfcn — common object file access routines 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

DESCRIPTION 

The common object file access routines are a collection of functions for reading 
an object file that is in VAX or 3B 20 computer (common) object file form. 
Although the calling program must know the detailed structure of the parts of 
the object file that it processes, the routines effectively insulate the calling pro- 
gram from knowledge of the overall structure of the object file. 

The interface between the calling program and the object file access routines is 
based on the defined type LDFILE, defined as struct ldfile, declared in the 
header file Idfcn.h. The primary purpose of this structure is to provide uniform 
access to both simple object files and to object files that are members of an 
archive file. 

The function ldopen( 3X) allocates and initializes the LDFILE structure and 
returns a pointer to the structure to the calling program. The fields of the 
LDFILE structure may be accessed individually through macros defined in 
Idfcn.h and contain the following information: 

LDFILE *ldptr; 

TYPE(ldptr) The file magic number used to distinguish between archive 
members and simple object files. 

IOPTR(ldptr) The file pointer returned by / open and used by the standard 
input/output functions. 

OFFSET(ldptr) The file address of the beginning of the object file; the offset is 
non-zero if the object file is a member of an archive file. 

HEADER (ldptr) The file header structure of the object file. 

The object file access functions themselves may be divided into four categories: 

(1) functions that open or close an object file 

Idopen (3X) and ldopen(3X) 

open a common object file 
ldclose{ 3X) and Idclose (3X) 

close a common object file 

(2) functions that read header or symbol table information 

Idahread (3X) 

read the archive header of a member of an archive file 
Idfhread (3X) 

read the file header of a common object file 
Idshread (3X) and Idshread (3X) 

read a section header of a common object file 
Idtbreadi 3X) 

read a symbol table entry of a common object file 
Idgetname (3X) 

retrieve a symbol name from a symbol table entry or 
from the string table 

(3) functions that position an object file at (seek to) the start of the 
section, relocation, or line number information for a particular section. 
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Idohseek (3X) 

seek to the optional file header of a common object file 
Idsseeki 3X) and Idsseek (3X) 

seek to a section of a common object file 
Idrseeki 3X) and l dr seek (3X) 

seek to the relocation information for a section of a 
common object file 
Idlseeki 3X) and Idlseeki 3X) 

seek to the line number information for a section of a 
common object file 
Idtbseek (3X) 

seek to the symbol table of a common object file 

(4) the function Idtbindexi 3X) which returns the index of a particular 
common object file symbol table entry. 

These functions are described in detail on their respective manual pages. 

All the functions except ldopen( 3X), Idgetnamei 3X), Idopeni 3X), and 
IdtbindexOX ) return either SUCCESS or FAILURE, both constants defined in 
ldfcn.h. Ldopen (3X) and Idopen (3X) both return pointers to an LDFILE struc- 
ture. 

Additional access to an object file is provided through a set of macros defined 
in ldfcn.h. These macros parallel the standard input/output file reading and 
manipulating functions, translating a reference of the LDFILE structure into a 
reference to its file descriptor field. 

The following macros are provided: 

GETC(ldptr) 

FGETC(ldptr) 

GETW(ldptr) 

UNGETC(c, ldptr) 

FGETS (s, n, ldptr) 

FREAD((char *) ptr, sizeof (*ptr), nitems, ldptr) 

FSEEK (ldptr, offset, ptrname) 

FTELL(ldptr) 

REWIND(ldptr) 

FEOF(ldptr) 

FERROR (ldptr) 

FILENO (ldptr) 

SETBUFOdptr, buf) 

STROFFSET(ldptr) 

The STROFFSET macro calculates the address of the string table in a UNIX 
system release 5.0 object file. See the manual entries for the corresponding 
standard input/output library functions for details on the use of the rest of the 
macros. 

The program must be loaded with the object file access routine library libld.a. 
WARNING 

The macro FSEEK defined in the header file ldfcn.h translates into a call to the 
standard input/output function fseeki 3S). FSEEK should not be used to seek 
from the end of an archive file since the end of an archive file may not be the 
same as the end of one of its object file members! 
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SEE ALSO 

fseek(3S), ldahread(3X), ldclose(3X), ldgetname(3X), ldfhread(3X), 
ldlread(3X), ldlseek(3X), ldohseek(3X), ldopen(3X), ldrseek(3X), ldlseek(3X), 
ldshread(3X), ldtbindex(3X), ldtbread(3X), ldtbseek(3X). fseek(3S), 
ldahread(3X), ldclose(3X), ldgetname(3X), ldfhread(3X), idlread(3X), 
ldlseek(3X), ldohseek(3X), ldopen(3X), ldrseek(3X), ldlseek(3X), 
ldshread(3X), ldtbindex(3X), ldtbread(3X), ldtbseek(3X), intro(5). 
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NAME 

linenum — line number entries in a common object file 
SYNOPSIS 

#include <linenum.h> 

DESCRIPTION 

Compilers based on pcc generate an entry in the object file for each C source 
line on which a breakpoint is possible (when invoked with the — g option; see 
cc(l)). Users can then reference line numbers when using the appropriate 
software test system (see sdb( 1)). The structure of these line number entries 
appears below. 


struct lineno 
{ 

union 

{ 



long 

lsymndx 

} 

long 

1 jiaddr ; 
l addr ; 

unsigned short 

l lnno ; 


) ; 

Numbering starts with one for each function. The initial line number entry for 
a function has IJnno equal to zero, and the symbol table index of the function’s 
entry is in Ijymndx. Otherwise, l lnno is non-zero, and / _paddr is the physi- 
cal address of the code for the referenced line. Thus the overall structure is the 
following: 


laddr 

llnno 

function symtab index 

0 

physical address 

line 

physical address 

line 

function symtab index 

0 

physical address 

line 

physical address 

line 


SEE ALSO 

a.out(4). 

cc(l), sdb(l) in the UNIX System V User Reference Manual. 
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NAME 

master — master device information table 
DESCRIPTION 

This file is used by the configi 1M) program to obtain device information that 
enables it to generate the configuration files. The file consists of 3 parts, each 
separated by a line with a dollar sign ($) in column 1. Part 1 contains device 
information; part 2 contains names of devices that have aliases; part 3 contains 
tunable parameter information. Any line with an asterisk (•) in column 1 is 
treated as a comment. 

Part 1 contains lines consisting of at least 10 fields and at most 13 fields, with 
the fields delimited by tabs and/or blanks: 

Field 1: device name (8 chars, maximum). 

Field 2: interrupt vector size (decimal, in bytes). 

Field 3: device mask (octal)— each “on” bit indicates that the 

handler exists: 

000100 initialization handler 
000040 power-failure handler 
000020 open handler 
000010 close handler 
000004 read handler 
000002 write handler 
000001 ioctl handler. 

Field 4: device type indicator (octal): 

000400 VAX-1 1/780 massbus adapter 

000200 allow only one of these devices 

000100 suppress count field in the conf.c file 

000040 suppress interrupt vector 

000020 required device 

000010 block device 

000004 character device 

000002 floating vector 

000001 fixed vector. 

Field 5: handler prefix (4 chars, maximum). 

Field 6: device address size (decimal). 

Field 7: major device number for block-type device. 

Field 8: major device number for character-type device. 

Field 9: maximum number of devices per controller (decimal). 

Field 10: maximum bus request level (4 through 7). 

Fields 11-13: optional configuration table structure declarations (8 
chars, maximum). 

Part 2 contains lines with 2 fields each: 

Field 1: alias name of device (8 chars, maximum). 

Field 2: reference name of device (8 chars, maximum; specified 

in part 1). 

Part 3 contains lines with 2 or 3 fields each: 

Field 1: parameter name (as it appears in description file; 20 

chars, maximum) 

Field 2: parameter name (as it appears in the conf.c file; 20 

chars, maximum) 

Field 3: default parameter value (20 chars, maximum; parameter 

specification is required if this field is omitted) 
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Devices that are not interrupt-driven have an interrupt vector size of zero. The 
040 bit in Field 4 causes configi 1M) to record the interrupt vector although 
the low.s (univec.c on the VAX-11/780) file will show no interrupt vector 
assignment at those locations (interrupts here will be treated as strays) . 

SEE ALSO 

config(lM) in the UNIX System V Administrator Reference Manual. 
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NAME 

mnttab — mounted file system table 
SYNOPSIS 


#include <mnttab.h> 


DESCRIPTION 


Mnttab resides in directory /etc and contains a table of devices, mounted by 
the mount (1M) command, in the following structure as defined by 

<mnttab.h>: 


struct mnttab { 


char 

mt_dev[32]; 

char 

mt_filsys[32]; 

short 

mt_ro_flg; 

timet 

mt_time; 


}; “ 

Each entry is 70 bytes in length; the first 32 bytes are the null-padded name of 
the place where the special file is mounted; the next 32 bytes represent the 
null-padded root name of the mounted special file; the remaining 6 bytes con- 
tain the mounted special file's read/write permissions and the date on which it 
was mounted. 

The maximum number of entries in mnttab is based on the system parameter 
NMOUNT located in /usr/src/uts/cf/conf.c, which defines the number of allow- 
able mounted special files. 

SEE ALSO 

mount(lM), setmnt(lM) in the UNIX System V Administrator Reference 
Manual. 
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NAME 

passwd — password file 
DESCRIPTION 

Passwd contains for each user the following information: 

login name 
encrypted password 
numerical user ID 
numerical group ID 

GCOS job number, box number, optional GCOS user ID 
initial working directory 
program to use as Shell 

This is an ASCII file. Each field within each user’s entry is separated from the 
next by a colon. The GCOS field is used only when communicating with that 
system, and in other installations can contain any desired information. Each 
user is separated from the next by a new-line. If the password field is null, no 
password is demanded; if the Shell field is null, the Shell itself is used. 

This file resides in directory /etc. Because of the encrypted passwords, it can 
and does have general read permission and can be used, for example, to map 
numerical user IDs to names. 

The encrypted password consists of 13 characters chosen from a 64-character 
alphabet (., /, 0—9, A— Z, a— z), except when the password is null, in which 
case the encrypted password is also null. Password aging is effected for a par- 
ticular user if his encrypted password in the password file is followed by a 
comma and a non-null string of characters from the above alphabet. (Such a 
string must be introduced in the first instance by the super-user.) 

The first character of the age, M say, denotes the maximum number of weeks 
for which a password is valid. A user who attempts to login after his password 
has expired will be forced to supply a new one. The next character, m say, 
denotes the minimum period in weeks which must expire before the password 
may be changed. The remaining characters define the week (counted from the 
beginning of 1970) when the password was last changed. (A null string is 
equivalent to zero.) M and m have numerical values in the range 0—63 that 
correspond to the 64-character alphabet shown above (i.e., / = 1 week; z = 63 
weeks). If m = M — 0 (derived from the string . or ..) the user will be forced 
to change his password the next time he logs in (and the “age” will disappear 
from his entry in the password file). If m > M (signified, e.g., by the string 
./) only the super-user will be able to change the password. 

FILES 

/etc/passwd 
SEE ALSO 

a641(3C), crypt (3C), getpwent(3C), group (4). 

login(l), passwd(l) in the UNIX System V User Reference Manual. 
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NAME 

plot — graphics interface 


DESCRIPTION 

Files of this format are produced by routines described in plot OX) and are 
interpreted for various devices by commands described in tploti 1G). A graph- 
ics file is a stream of plotting instructions. Each instruction consists of an 
ASCII letter usually followed by bytes of binary information. The instructions 
are executed in order. A point is designated by four bytes representing the x 
and y values; each value is a signed integer. The last designated point in an 1, 
m, n, or p instruction becomes the “current point” for the next instruction. 

Each of the following descriptions begins with the name of the corresponding 
routine in plotOX). 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point given by the next four 
bytes. See t plot 1 1G). 

p point: Plot the point given by the next four bytes. 

I line: Draw a line from the point given by the next four bytes to the point 
given by the following four bytes. 

t label: Place the following ASCII string so that its first character falls on the 
current point. The string is terminated by a new-line. 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a new-line, as the style for draw- 
ing further lines. The styles are “dotted”, “solid”, “longdashed”, “short- 
dashed”, and “dotdashed”. Effective only for the — T4014 and —Tver 
options of tplotOG) (TEKTRONIX 4014 terminal and Versatec plotter). 

s space: The next four bytes give the lower left corner of the plotting area; 
the following four give the upper right corner. The plot will be magnified or 
reduced to fit the device as closely as possible. 


Space settings that exactly fill the plotting area with unity scaling appear below 
for devices supported by the filters of tplotk 1G). The upper limit is just outside 
the plotting area. In every case the plotting area is taken to be square; points 
outside may be displayable on devices whose face is not square. 


DASI 300 
DASI 300s 
DASI 450 
TEKTRONIX 4014 
Versatec plotter 


space(0, 0, 4096, 4096); 
space(0, 0, 4096, 4096); 
space (0, 0, 4096, 4096); 
space (0, 0, 3120, 3120); 
space(0, 0, 2048, 2048); 


SEE ALSO 

plot(3X), gps(4), term (5). 

graph(lG), tplot(lG) in the UNIX System V User Reference Manual. 


WARNING 

The plotting library plotOX ) and the curses library curses OX) both use the 
names erase 0 and moveO. The curses versions are macros. If you need both 
libraries, put the plotOX) code in a different source file than the curses OX) 
code, and/or #undef moveO and eraseO in the plotOX) code. 
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NAME 

pnch — file format for card images 
DESCRIPTION 

The PNCH format is a convenient representation for files consisting of card 
images in an arbitrary code. 

A PNCH file is a simple concatenation of card records. A card record consists 
of a single control byte followed by a variable number of data bytes. The con- 
trol byte specifies the number (which must lie in the range 0-80) of data bytes 
that follow. The data bytes are 8-bit codes that constitute the card image. If 
there are fewer than 80 data bytes, it is understood that the remainder of the 
card image consists of trailing blanks. 

SEE ALSO 

send (1C) in the UNIX System V User Reference Manual. 
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NAME 

profile — setting up an environment at login time 


DESCRIPTION 

If your login directory contains a file named .profile, that file will be executed 
(via exec .profile) before your session begins; .profiles are handy for setting 
exported environment variables and terminal modes. If the file /etc/profile 
exists, it will be executed for every user before the .profile. The following 
example is typical (except for the comments): 


# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

# Tell me when new mail comes in 
M AIL=/ usr/ mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 

# Set terminal type 
echo "terminal: \c" 
read TERM 

case $TERM in 


300) 

300s) 

450) 

hp) 

745 | 735) 
43) 

4014 | tek) 

*) 


stty cr2 nlO tabs; tabs;; 

stty cr2 nlO tabs; tabs;; 

stty cr2 nlO tabs; tabs;; 

stty crO nlO tabs; tabs;; 

stty crl nil —tabs; TERM=745;; 

stty crl nlO —tabs;; 

stty crO nlO —tabs ffl; TERM=4014; echo "\33;";; 
echo "STERM unknown";; 


esac 


FILES 

$HOME/.profile 

/etc/profile 

SEE ALSO 

environ (5), term (5). 

env(l), login(l), mail(l), sh(l), stty(l), su(l) in the UNIX System V User 
Reference Manual. 
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NAME 

reloc — relocation information for a common object file 

SYNOPSIS 

#include <reloc.h> 

DESCRIPTION 

Object files have one relocation entry for each relocatable reference in the text 
or data. If relocation information is present, it will be in the following format. 


struct reloc 

f 



i 

long 

r vaddr ; 

/* (virtual) address of reference */ 

long 

r symndx ; 

/* index into symbol table */ 

short 

} ; 

r_type ; 

/* relocation type */ 

/* 



* All generics 




* reloc. already performed to symbol in the same section 

*/ 

#define RABS 0 


/* 

* 3B computer generic 

* 24-bit direct reference 

* 24-bit “relative” reference 

* 16-bit optimized “indirect” TV reference 

* 24-bit “indirect” TV reference 

* 32-bit “indirect” TV reference 

*/ 

#define R_DIR24 04 

#define RREL24 05 

#define R_OPT16 014 

#define R IND24 015 

#define R IND32 016 


/* 

* DEC Processors VAX 11/780 and VAX 11/750 

* 


*/ 


#define RRELBYTE 

017 

#define R RELWORD 

020 

#define R RELLONG 

021 

#define R_PCRBYTE 

022 

#define R PCRWORD 

023 

#define R PCRLONG 

024 


- 1 - 



REL0C(4) 


(not on PDP-1 1) 


RELOC (4) 


As the link editor reads each input section and performs relocation, the reloca- 
tion entries are read. They direct how references found within the input section 
are treated. 

R ABS The reference is absolute, and no relocation is necessary. The 

entry will be ignored. 

R DIR24 A direct, 24-bit reference to a symbol’s virtual address. 

R REL24 A “PC-relative”, 24-bit reference to a symbol’s virtual address. 

Relative references occur in instructions such as jumps and calls. 
The actual address used is obtained by adding a constant to the 
value of the program counter at the time the instruction is exe- 
cuted. 

R OPT16 An optimized, indirect, 16-bit reference through a transfer vector. 

The instruction contains the offset into the transfer vector table to 
the transfer vector where the actual address of the referenced 
word is stored. 

R IND24 An indirect, 24-bit reference through a transfer vector. The 

instruction contains the virtual address of the transfer vector, 
where the actual address of the referenced word is stored. 

R IND32 An indirect, 32-bit reference through a transfer vector. The 

instruction contains the virtual address of the transfer vector, 
where the actual address of the referenced word is stored. 

R RELBYTE A direct 8-bit reference to a symbol’s virtual address. 
RRELWORD 

A direct 16-bit reference to a symbol’s virtual address. 

RRELLONG 

A direct 32-bit reference to a symbol’s virtual address. 

R PCRBYTE A “PC-relative”, 8-bit reference to a symbol’s virtual address. 
RPCRWORD 

A “PC-relative”, 16-bit reference to a symbol’s virtual address. 

RPCRLONG 

A “PC -relative”, 32-bit reference to a symbol’s virtual address. 

On the VAX processors relocation of a symbol index of -1 indicates that the 
relative difference between the current segment’s start address and the 
program’s load address is added to the relocatable address. 

Other relocation types will be defined as they are needed. 

Relocation entries are generated automatically by the assembler and automati- 
cally utilized by the link editor. A link editor option exists for removing the 
relocation entries from an object file. 

SEE ALSO 

a. out (4), syms(4). 

Id ( 1 ) , strip (1) in the UNIX System V User Reference Manual. 
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NAME 

sccsfile — format of SCCS file 
DESCRIPTION 

An SCCS file is an ASCII file. It consists of six logical parts: the checksum, the 
delta table (contains information about each delta), user names (contains 
login names and/or numerical group IDs of users who may add deltas), flags 
(contains definitions of internal keywords), comments (contains arbitrary 
descriptive information about the file), and the body (contains the actual text 
lines intermixed with control lines). 

Throughout an SCCS file there are lines which begin with the ASCII SOH (start 
of heading) character (octal 001). This character is hereafter referred to as 
the control character and will be represented graphically as @. Any line 
described below which is not depicted as beginning with the control character is 
prevented from beginning with the control character. 

Entries of the form DDDDD represent a five-digit string (a number between 
00000 and 99999). 

Each logical part of an SCCS file is described in detail below. 

Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 

@hDDDDD 

The value of the checksum is the sum of all characters, except those of 
the first line. The @h provides a magic number of (octal) 064001. 

Delta table 

The delta table consists of a variable number of entries of the form: 

@S DDDDD/ DDDDD/ DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
@i DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@m <MR number > 


@c <comments> ... 


@e 

The first line (@s) contains the number of lines 
inserted/deleted/unchanged, respectively. The second line (@d) con- 
tains the type of the delta (currently, normal: D, and removed: R), the 
SCCS ID of the delta, the date and time of creation of the delta, the 
login name corresponding to the real user ID at the time the delta was 
created, and the serial numbers of the delta and its predecessor, respec- 
tively. 

The @i, @x, and @g lines contain the serial numbers of deltas 
included, excluded, and ignored, respectively. These lines are optional. 

The @m lines (optional) each contain one MR number associated with 
the delta; the @c lines contain comments associated with the delta. 
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The @e line ends the delta table entry. 

User names 

The list of login names and/or numerical group IDs of users who may 
add deltas to the file, separated by new-lines. The lines containing 
these login names and/or numerical group IDs are surrounded by the 
bracketing lines @u and @U. An empty list allows anyone to make a 
delta. Any line starting with a ! prohibits the succeeding group or user 
from making deltas. 

Flags 

Keywords used internally (see admin (1) for more information on their 
use). Each flag line takes the form: 


@f <flag> < optional text> 


The following flags are defined: 


@f t <type of program > 

@f v < program name> 

@f i < keyword string > 

@f b 

@f m <module name> 

@f f < floor > 

@f c < ceiling > 

@f d <default-sid> 

@f n 
@f j 

@f 1 < lock-releases > 

@f q <user defined > 

@f z < reserved for use in interfaces > 

The t flag defines the replacement for the %Y% identification keyword. 
The v flag controls prompting for MR numbers in addition to com- 
ments; if the optional text is present it defines an MR number validity 
checking program. The i flag controls the warning/error aspect of the 
“No id keywords” message. When the i flag is not present, this mes- 
sage is only a warning; when the i flag is present, this message will 
cause a “fatal” error (the file will not be gotten, or the delta will not 
be made). When the b flag is present the — b keyletter may be used 
on the get command to cause a branch in the delta tree. The m flag 
defines the first choice for the replacement text of the %M% 
identification keyword. The f flag defines the “floor” release; the 
release below which no deltas may be added. The c flag defines the 
“ceiling” release; the release above which no deltas may be added. 
The d flag defines the default SID to be used when none is specified on 
a get command. The n flag causes delta to insert a “null” delta (a 
delta that applies no changes) in those releases that are skipped when 
a delta is made in a new release (e.g., when delta 5.1 is made after 
delta 2.7, releases 3 and 4 are skipped). The absence of the n flag 
causes skipped releases to be completely empty. The j flag causes get 
to allow concurrent edits of the same base SID. The 1 flag defines a list 
of releases that are locked against editing {get{ 1) with the — e 
keyletter). The q flag defines the replacement for the %Q% 
identification keyword. The z flag is used in certain specialized inter- 
face programs. 
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Comments 

Arbitrary text is surrounded by the bracketing lines @t and @T. The 
comments section typically will contain a description of the file’s pur- 
pose. 

Body 

The body consists of text lines and control lines. Text lines do not 
begin with the control character, control lines do. There are three 
kinds of control lines: insert, delete, and end, represented by: 

@1 DDDDD 
@D DDDDD 
@E DDDDD 

respectively. The digit string is the serial number corresponding to the 
delta for the control line. 

SEE ALSO 

admin(l), delta (1), get(l), prs(l) in the UNIX System V User Reference 
Manual. 

Source Code Control System User Guide in the UNIX System V User Guide. 
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NAME 

scnhdr — section header for a common object file 
SYNOPSIS 

#include <scnhdr.h> 


DESCRIPTION 

Every common object file has a table of section headers to specify the layout of 
the data within the file. Each section within an object file has its own header. 
The C structure appears below. 


struct scnhdr 

{ 

char s_name[SYMNMLEN]; /* section name */ 


long 

s_paddr; 

long 

s_vaddr; 

long 

s_size; 

long 

sscnptr; 

long 

srelptr; 

long 

sjnnoptr; 

unsigned short 

snreloc; 

unsigned short 

s_nlnno; 

long 

sjlags; 


/* physical address */ 

/* virtual address */ 

/» section size */ 

/ » file ptr to raw data »/ 

/* file ptr to relocation »/ 

/* file ptr to line numbers */ 
/* # reloc entries */ 

/* # line number entries */ 
/* flags */ 


File pointers are byte offsets into the file; they can be used as the offset in a 
call to fseek( 3S). If a section is initialized, the file contains the actual bytes. 
An uninitialized section is somewhat different. It has a size, symbols defined in 
it, and symbols that refer to it. But it can have no relocation entries, line 
numbers, or data. Consequently, an uninitialized section has no raw data in the 
object file, and the values for s_scnptr, s_relptr, sjnnoptr, snreloc , and 
sjilnno are zero. 

SEE ALSO 

fseek(3S), a. out (4). 

Id ( 1 ) in the UNIX System V User Reference Manual. 
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NAME 

syms — common object file symbol table format 

SYNOPSIS 

#include <syms.h> 

DESCRIPTION 

Common object files contain information to support symbolic software testing 
(see sdb{ 1)). Line number entries, linenum (4) , and extensive symbolic infor- 
mation permit testing at the C source level. Every object file’s symbol table is 
organized as shown below. 

File name 1. 

Function 1. 

Local symbols for function 1 . 

Function 2. 

Local symbols for function 2. 

Static externs for file 1. 

File name 2. 

Function 1. 

Local symbols for function 1. 

Function 2. 

Local symbols for function 2. 

Static externs for file 2. 


Defined global symbols. 

Undefined global symbols. 

The entry for a symbol is a fixed-length structure. The members of the struc- 
ture hold the name (null padded), its value, and other information. The C 
structure is given below. 

#define SYMNMLEN 8 

#define FILNMLEN 14 


struct syment 

{ 

union /* all ways to get symbol name */ 

{ 

char _n_name[SYMNMLEN]; /» symbol name »/ 

struct 


{ 


long 

n zeroes; 

/» == OL when in string table */ 

long 

n offset; 

/* location of name in table */ 

} n n; 



char 

•_n_ n ptr[2]; 

/* allows overlaying »/ 

) _n, 
long 

n value; 

/* value of symbol »/ 

short 

n scnum; 

/» section number */ 

unsigned short 

n type; 

/* type and derived type */ 

char 

n sclass; 

/* storage class */ 

char 

}; 

nnumaux; 

/* number of aux entries */ 

#define n name 

n. n name 
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#define n_zeroes _n._n_n._n_zeroes 

#define noffset _n._n_n._n_offset 

#define n_nptr ji._n_nptr[ 1 ] 

Meaningful values and explanations for them are given in both syms.h and 
Common Object File Format. Anyone who needs to interpret the entries 
should seek more information in these sources. Some symbols require more 
information than a single entry; they are followed by auxiliary entries that are 
the same size as a symbol entry. The format follows. 

union auxent 

{ 

struct 


long xtagndx; 

union 

{ 

struct 

{ 

unsigned short x_lnno; 

unsigned short x size; 

} xjnsz; 
long xfsize; 

} x_misc; 
union 
{ 

struct 

{ 

long xlnnoptr; 

long xendndx; 

} x_fcn; 

struct 

( 

unsigned short x_dimen[DIMNUM]; 
} x_ary; 

} x_fcnary; 

unsigned short x tvndx; 

} x_sym; 

struct 

{ 

char x_fname[FILNMLEN]; 

} xflle; 

struct 

{ 

long xscnlen; 
unsigned short x nreloc; 
unsigned short x nlinno; 

} x_scn; 

struct 

{ 

long xtvfill; 

unsigned short x_tvlen; 
unsigned short x_tvran[2]; 

} x_tv; 
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Indexes of symbol table entries begin at zero. 

SEE ALSO 

a.out(4), linenum(4). 

sdb(l) in the UNIX System V User Reference Manual. 

CAVEATS 

On machines in which longs are equivalent to ints 3B 20 computer, VAX), they 
are converted to ints in the compiler to minimize the complexity of the compiler 
code generator. Thus the information about which symbols are declared as 
longs and which, as ints, does not show up in the symbol table. 
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NAME 

term — format of compiled term file. 

SYNOPSIS 

term 

DESCRIPTION 

Compiled terminfo descriptions are placed under the directory 
/usr/lib/terminfo. In order to avoid a linear search of a huge UNIX system 
directory, a two-level scheme is used: /usr/lib/terminfo/c/name where name is 
the name of the terminal, and c is the first character of name. Thus, act4 can 
be found in the file /usr/lib/terminfo/a/act4. Synonyms for the same terminal 
are implemented by multiple links to the same compiled file. 

The format has been chosen so that it will be the same on all hardware. An 8 
or more bit byte is assumed, but no assumptions about byte ordering or sign 
extension are made. 

The compiled file is created with the compile program, and read by the routine 
setupterm. Both of these pieces of software are part of curses (3X) . The file is 
divided into six parts: the header, terminal names, boolean flags, numbers, 
strings, and string table. 

The header section begins the file. This section contains six short integers in 
the format described below. These integers are (1) the magic number (octal 
0432); (2) the size, in bytes, of the names section; (3) the number of bytes in 
the boolean section; (4) the number of short integers in the numbers section; 
(5) the number of offsets (short integers) in the strings section; (6) the size, in 
bytes, of the string table. 

Short integers are stored in two 8-bit bytes. The first byte contains the least 
significant 8 bits of the value, and the second byte contains the most significant 
8 bits. (Thus, the value represented is 256*second+first.) The value —1 is 
represented by 0377, 0377, other negative value are illegal. The —1 generally 
means that a capability is missing from this terminal. Note that this format 
corresponds to the hardware of the VAX and PDP-11. Machines where this 
does not correspond to the hardware read the integers as two bytes and com- 
pute the result. 

The terminal names section comes next. It contains the first line of the ter- 
minfo description, listing the various names for the terminal, separated by the f 
character. The section is terminated with an ASCII NUL character. 

The boolean flags have one byte for each flag. This byte is either 0 or 1 as the 
flag is present or absent. The capabilities are in the same order as the file 
<term.h>. 

Between the boolean section and the number section, a null byte will be 
inserted, if necessary, to ensure that the number section begins on an even byte. 
All short integers are aligned on a short word boundary. 

The numbers section is similar to the flags section. Each capability takes up 
two bytes, and is stored as a short integer. If the value represented is —1, the 
capability is taken to be missing. 

The strings section is also similar. Each capability is stored as a short integer, 
in the format above. A value of —1 means the capability is missing. Other- 
wise, the value is taken as an offset from the beginning of the string table. 
Special characters in ~X or \c notation are stored in their interpreted form, not 
the printing representation. Padding information $<nn> and parameter infor- 
mation %x are stored intact in uninterpreted form. 
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The final section is the string table. It contains all the values of string capabili- 
ties referenced in the string section. Each string is null terminated. 

Note that it is possible for setupterm to expect a different set of capabilities 
than are actually present in the file. Either the database may have been 
updated since setupterm has been recompiled (resulting in extra unrecognized 
entries in the file) or the program may have been recompiled more recently 
than the database was updated (resulting in missing entries). The routine 
setupterm must be prepared for both possibilities — this is why the numbers 
and sizes are included. Also, new capabilities must always be added at the end 
of the lists of boolean, number, and string capabilities. 

As an example, an octal dump of the description for the Microterm ACT 4 is 
included: 

microterm|act4|microterm act iv, 

cr='M, cudl=*J, ind=*J, bel="G, am, cubl^H, 
ed= A _, el=“, clear='L, cup='T%pl%c%p2%c, 
cols#80, lines#24, cufl="X, cuul=”Z, home="], 


000 

032 

001 


\0 

025 

\0 

\b 

\0 

212 

\0 

" 

\0 

m 

i 

c 

r 

020 

o 

t 

e 

r 

m 

i 

a 

c 

t 

4 

i 

i 

m 

i 

c 

r 

o 

040 

t 

e 

r 

m 


a 

c 

t 


i 

V 

\0 

\0 

001 

\0 

\0 

060 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

\0 

100 

\0 

\0 

P 

\0 

377 

377 

030 

\0 

377 

377 

377 

377 

377 

377 

377 

377 

120 

377 

377 

377 

377 

\0 

\0 

002 

\0 

377 

377 

377 

377 

004 

\0 

006 

\0 

140 

\b 

\0 

377 

377 

377 

377 

\n 

\0 

026 

\0 

030 

\0 

377 

377 

032 

\0 

160 

377 

377 

377 

377 

034 

\0 

377 

377 

036 

\0 

377 

377 

377 

377 

377 

377 

200 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

520 

377 

377 

377 

377 


\0 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

540 

377 

377 

377 

377 

377 

377 

007 

\0 

\r 

\0 

\f 

\0 

036 

\0 

037 

\0 

560 

024 

% 

P 

1 

% 

c 

% 

P 

2 

% 

c 

\0 

\n 

\0 

035 

\0 

600 

\b 

\0 

030 

\0 

032 

\0 

\n 

\0 










Some limitations: total compiled entries cannot exceed 4096 bytes. The name 
field cannot exceed 128 bytes. 

FILES 

/usr/lib/terminfo/*/* compiled terminal capability data base 
SEE ALSO 

curses(3X), terminfo(4). 
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NAME 

terminfo — terminal capability data base 

SYNOPSIS 

/usr/lib/terminfo/*/* 

DESCRIPTION 

Terminfo is a data base describing terminals, used, e.g.,, by v; ( 1 ) and 
curses { 3X). Terminals are described in terminfo by giving a set of capabilities 
which they have, and by describing how operations are performed. Padding 
requirements and initialization sequences are included in terminfo. 

Entries in terminfo consist of a number of separated fields. White space 
after each is ignored. The first entry for each terminal gives the names 
which are known for the terminal, separated by f characters. The first name 
given is the most common abbreviation for the terminal, the last name given 
should be a long name fully identifying the terminal, and all others are under- 
stood as synonyms for the terminal name. All names but the last should be in 
lower case and contain no blanks; the last name may well contain upper case 
and blanks for readability. 

Terminal names (except for the last, verbose entry) should be chosen using the 
following conventions. The particular piece of hardware making up the termi- 
nal should have a root name chosen, thus “hp2621”. This name should not 
contain hyphens, except that synonyms may be chosen that do not conflict with 
other names. Modes that the hardware can be in, or user preferences, should 
be indicated by appending a hyphen and an indicator of the mode. Thus, a 
vtlOO in 132 column mode would be vtlOO-w. The following suffixes should be 
used where possible: 


Suffix 

Meaning 

Example 

-w 

Wide mode (more than 80 columns) 

vtlOO-w 

-am 

With auto, margins (usually default) 

vtlOO-am 

-nam 

Without automatic margins 

vtlOO-nam 

-n 

Number of lines on the screen 

aaa-60 

-na 

No arrow keys (leave them in local) 

clOO-na 

-np 

Number of pages of memory 

cl00-4p 

-rv 

Reverse video 

clOO-rv 


CAPABILITIES 

The variable is the name by which the programmer (at the terminfo level) 
accesses the capability. The capname is the short name used in the text of the 
database, and is used by a person updating the database. The i.code is the two 
letter internal code used in the compiled database, and always corresponds to 
the old termcap capability name. 

Capability names have no hard length limit, but an informal limit of 5 charac- 
ters has been adopted to keep them short and to allow the tabs in the source 
file caps to line up nicely. Whenever possible, names are chosen to be the same 
as or similar to the ANSI X3.64-1979 standard. Semantics are also intended 
to match those of the specification. 

(P) indicates that padding may be specified 

(G) indicates that the string is passed through tparm withparms as given 

(#/) . 

(*) indicates that padding may be based on the number of lines affected 
(#•) indicates the i' 1 ^ 1 parameter. 
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Variable 

Cap- 

I. 

Booleans 

name 

Code 

auto_left_margin, 

bw 

bw 

autorightmargin, 

am 

am 

beehivejglitch, 

xsb 

xb 

ceol_standout_glitch, 

xhp 

xs 

eat_newline_glitch, 

xenl 

xn 

eraseoverstrike, 

eo 

eo 

generic_type, 

gn 

gn 

hard_copy, 

he 

he 

has_meta_key, 

km 

km 

hasjstatusline, 

hs 

hs 

insertnull _glitch, 

in 

in 

memory_above, 

da 

da 

memory_below. 

db 

db 

move_insert_mode, 

mir 

mi 

movestandoutmode, 

msgr 

ms 

overstrike. 

os 

os 

statuslineescok, 

eslok 

es 

telerayjglitch, 

xt 

xt 

tilde_glitch. 

hz 

hz 

transparentunderline, 

ul 

ul 

xonxoff, 

xon 

xo 

Numbers: 



columns, 

cols 

CO 

init_tabs, 

it 

it 

lines, 

lines 

li 

lines_of_memory, 

lm 

lm 

magic_cookie_glitch, 

xmc 

sg 

padding_baud_rate. 

pb 

pb 

virtualterminal, 

vt 

vt 

widthstatusjine, 

wsl 

ws 

Strings: 



backtab, 

cbt 

bt 

bell, 

bel 

bl 

carriagereturn, 

cr 

cr 

change_scroll_region, 

csr 

cs 

clear_all_tabs, 

tbc 

ct 

clear_screen, 

clear 

cl 

clr_eol, 

el 

ce 

clr_eos, 

ed 

cd 

columnaddress, 

hpa 

ch 

commandcharacter. 

emdeh 

CC 

cursoraddress, 

cup 

cm 

cursordown, 

cudl 

do 

cursor_home, 

home 

ho 

cursorinvisible, 

civis 

vi 

cursorleft, 

cubl 

le 

cursormemaddress, 

mrcup 

CM 

cursornormal, 

cnorm 

ve 

cursorright, 

cufl 

nd 

cursortoll, 

11 

11 

cursor_up. 

cuul 

up 

cursorvisible, 

ewis 

vs 

deletecharacter, 

dehl 

dc 
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Description 

cubl wraps from column 0 to last column 
Terminal has automatic margins 
Beehive (fl=escape, f2=ctrl C) 

Standout not erased by overwriting (hp) 
newline ignored after SO cols (Concept) 
Can erase overstrikes with a blank 
Generic line type (e.g.„ dialup, switch). 
Hardcopy terminal 

Has a meta key (shift, sets parity bit) 

Has extra "status line" 

Insert mode distinguishes nulls 
Display may be retained above the screen 
Display may be retained below the screen 
Safe to move while in insert mode 
Safe to move in standout modes 
Terminal overstrikes 
Escape can be used on the status line 
Tabs ruin, magic so char (Teleray 1061) 
Hazeltine; can not print *’s 
underline character overstrikes 
Terminal uses xon/xoff handshaking 


Number of columns in a line 

Tabs initially every # spaces 

Number of lines on screen or page 

Lines of memory if > lines. 0 means varies 

Number of blank chars left by smso or rmso 

Lowest baud where cr/nl padding is needed 

Virtual terminal number (UNIX system) 

No. columns in status line 


Back tab (P) 

Audible signal (bell) (P) 

Carriage return (P*) 

change to lines #1 through #2 (vtlOO) (PG) 
Clear all tab stops (P) 

Clear screen and home cursor (P*) 

Clear to end of line (P) 

Clear to end of display (P*) 

Set cursor column (PG) 

Term, settable cmd char in prototype 
Screen rel. cursor motion row #1 col #2 (PG) 
Down one line 
Home cursor (if no cup) 

Make cursor invisible 
Move cursor left one space 
Memory relative cursor addressing 
Make cursor appear normal (undo vs/vi) 
Non-destructive space (cursor right) 

Last line, first column (if no cup) 

Upline (cursor up) 

Make cursor very visible 
Delete character (P*) 
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deleteline, 

dll 

dl 

dis_status_line, 

dsl 

ds 

down_half_line, 

hd 

hd 

enteraltcharsetmode, 

smacs 

as 

enterblinkmode, 

blink 

mb 

enter_bold_mode, 

bold 

md 

enter_ca_mode, 

smcup 

ti 

enterdeletemode, 

smdc 

dm 

enterdimmode, 

dim 

mh 

enterinsertmode, 

smir 

im 

enter_protected_mode, 

prot 

mp 

enter reverse mode, 

rev 

mr 

enter_secure_mode, 

invis 

mk 

enter standout mode, 

smso 

so 

enterunderlinemode, 

smul 

us 

erasechars 

ech 

ec 

exit alt charset mode, 

rmacs 

ae 

exit_attribute_mode, 

sgrO 

me 

exit_ca_mode, 

rmcup 

te 

exitdeletemode, 

rmdc 

ed 

exit_insert_mode, 

rmir 

ei 

exit standout mode, 

rmso 

se 

exit_underline_mode, 

rmul 

ue 

flash_screen, 

flash 

vb 

formfeed, 

ff 

ff 

fromstatusline, 

fsl 

fs 

init_l string. 

isl 

il 

init_2string, 

is2 

i2 

init_3string, 

is3 

i3 

initfile, 

if 

if 

insert_character, 

ichl 

ic 

insertjine. 

ill 

al 

insert_padding, 

‘P 

ip 

key_backspace, 

kbs 

kb 

key_catab, 

ktbc 

ka 

keyclear, 

kclr 

kC 

keyctab, 

kctab 

kt 

keydc, 

kdchl 

kD 

keydl, 

kdll 

kL 

key_down, 

kcudl 

kd 

key_eic, 

krmir 

kM 

keyed, 

kel 

kE 

keyeos, 

ked 

kS 

keyfO, 

kfO 

kO 

key_fl. 

kfl 

kl 

keyflO, 

kflO 

ka 

key_f2, 

kf2 

k2 

key_f3. 

kf3 

k3 

key_f4, 

kf4 

k4 

key_f5, 

kf5 

k5 

key_f6, 

kf6 

k6 

key_f7, 

kn 

k7 

key_f8, 

kf8 

k8 

key_f9, 

kf9 

k9 

key_home, 

khome 

kh 

keyic. 

kichl 

kl 

keyil, 

kill 

kA 
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Delete line (P*) 

Disable status line 

Half-line down (forward 1/2 linefeed) 
Start alternate character set (P) 

Turn on blinking 
Turn on bold (extra bright) mode 
String to begin programs that use cup 
Delete mode (enter) 

Turn on half-bright mode 
Insert mode (enter); 

Turn on protected mode 

Turn on reverse video mode 

Turn on blank mode (chars invisible) 

Begin stand out mode 

Start underscore mode 

Erase #1 characters (PG) 

End alternate character set (P) 

Turn off all attributes 

String to end programs that use cup 

End delete mode 

End insert mode 

End stand out mode 

End underscore mode 

Visible bell (may not move cursor) 

Hardcopy terminal page eject (P*) 

Return from status line 

Terminal initialization string 

Terminal initialization string 

Terminal initialization string 

Name of file containing is 

Insert character (P) 

Add new blank line (P*) 

Insert pad after character inserted (P*) 

Sent by backspace key 

Sent by clear-all-tabs key 

Sent by clear screen or erase key 

Sent by clear-tab key 

Sent by delete character key 

Sent by delete line key 

Sent by terminal down arrow key 

Sent by rmir or smir in insert mode 

Sent by clear-to-end-of-line key 

Sent by clear-to-end-of-screen key 

Sent by function key fO 

Sent by function key fl 

Sent by function key flO 

Sent by function key f2 

Sent by function key f3 

Sent by function key f4 

Sent by function key f5 

Sent by function key f6 

Sent by function key f7 

Sent by function key f8 

Sent by function key f9 

Sent by home key 

Sent by ins char/ enter ins mode key 
Sent by insert line 
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key left, 

kcubl 

kl 

keyjl, 

kll 

kH 

key_npage, 

knp 

kN 

key_ppage. 

kpp 

kP 

keyright. 

kcufl 

kr 

key_sf, 

kind 

kF 

key_sr, 

kri 

kR 

key stab, 

khts 

kT 

key up, 

kcuul 

ku 

keypadjocal, 

rmkx 

ke 

keypad_xmit. 

smkx 

ks 

labfO, 

lfO 

10 

labfl, 

Ifl 

11 

lab_flO, 

If 10 

la 

lab_f2, 

lf2 

12 

lab_f3. 

lf3 

13 

lab_f4. 

lf4 

14 

lab_f5, 

lf5 

15 

lab f6, 

lf6 

16 

lab_f7. 

in 

17 

lab f8, 

lf8 

18 

lab_f9. 

lf9 

19 

metaon, 

smm 

mm 

metaoff. 

rmm 

mo 

newline, 

nel 

nw 

padchar, 

pad 

pc 

parm_dch, 

dch 

DC 

parmdeletejine, 

dl 

DL 

parm_down_cursor, 

cud 

DO 

parmjch, 

ich 

IC 

parmjndex, 

indn 

SF 

parm_insert_line, 

il 

AL 

parm_left_cursor, 

cub 

LE 

parmrightcursor, 

cuf 

RI 

parmrindex. 

rin 

SR 

parmupcursor, 

cuu 

UP 

pkeykey, 

pfkey 

pk 

pkeylocal, 

pfloc 

Pi 

pkey_xmit, 

pfx 

px 

printscreen, 

mcO 

ps 

prtroff. 

mc4 

Pf 

prtr_on, 

mc5 

po 

repeat_char, 

rep 

rp 

reset_l string, 

rsl 

rl 

reset_2string, 

rs2 

r2 

reset_3string. 

rs3 

r3 

resetfile, 

rf 

rf 

restore_cursor, 

rc 

rc 

rowaddress. 

vpa 

cv 

save_cursor, 

sc 

sc 

scrollforward, 

ind 

sf 

scrollreverse, 

ri 

sr 

set_attributes, 

sgr 

sa 

settab, 

hts 

St 

setwindow, 

wind 

wi 

tab, 

ht 

ta 

to_status_line, 

tsl 

ts 
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Sent by terminal left arrow key 

Sent by home-down key 

Sent by next-page key 

Sent by previous-page key 

Sent by terminal right arrow key 

Sent by scroll-forward/down key 

Sent by scroll-backward/up key 

Sent by set-tab key 

Sent by terminal up arrow key 

Out of "keypad transmit" mode 

Put terminal in "keypad transmit" mode 

Labels on function key fO if not fO 

Labels on function key fl if not fl 

Labels on function key flO if not flO 

Labels on function key f2 if not f2 

Labels on function key f3 if not f3 

Labels on function key f4 if not f4 

Labels on function key f5 if not f5 

Labels on function key f6 if not f6 

Labels on function key f7 if not f7 

Labels on function key f8 if not f8 

Labels on function key f9 if not f9 

Turn on "meta mode" (8th bit) 

Turn off "meta mode" 

Newline (behaves like cr followed by If) 
Pad character (rather than null) 

Delete #1 chars (PG*) 

Delete #1 lines (PG*) 

Move cursor down #1 lines (PG*) 

Insert #1 blank chars (PG*) 

Scroll forward #1 lines (PG) 

Add #1 new blank lines (PG*) 

Move cursor left #1 spaces (PG) 

Move cursor right #1 spaces (PG*) 

Scroll backward #1 lines (PG) 

Move cursor up #1 lines (PG*) 

Prog funct key #1 to type string #2 

Prog funct key #1 to execute string #2 

Prog funct key #1 to xmit string #2 

Print contents of the screen 

Turn off the printer 

Turn on the printer 

Repeat char #1 #2 times. (PG*) 

Reset terminal completely to sane modes. 
Reset terminal completely to sane modes. 
Reset terminal completely to sane modes. 
Name of file containing reset string 
Restore cursor to position of last sc 
Vertical position absolute (set row) (PG) 
Save cursor position (P) 

Scroll text up (P) 

Scroll text down (P) 

Define the video attributes (PG9) 

Set a tab in all rows, current column 
Current window is lines #l-#2 cols #3-#4 
Tab to next 8 space hardware tab stop 
Go to status line, column #1 
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underline char. 

uc 

uc 

upjhalfjine, 

hu 

hu 

init_prog, 

iprog 

iP 

key_al. 

kal 

K1 

key_a3, 

ka3 

K3 

key_b2, 

kb2 

K2 

keycl, 

kcl 

K4 

key_c3, 

kc3 

K5 

prtrnon. 

mc5p 

pO 

A Sample Entry 




Underscore one char and move past it 

Half-line up (reverse 1/2 linefeed) 

Path name of program for init 

Upper left of keypad 

Upper right of keypad 

Center of keypad 

Lower left of keypad 

Lower right of keypad 

Turn on the printer for #1 bytes 


The following entry, which describes the Concept- 100, is among the more 
complex entries in the terminfo file as of this writing. 


concept 100 ! clOO! concept ! c104 ! c100-4p ! concept 100, 

am, bel="G, blank=\EH, blink=\EC, clear=‘L$<2.> , cnorm=\Ew, 
cols#80, cr= A M$<9> , cub1=~H, cudl^J, cuf1=\E=, 
cup=\Ea%p1%' '%+XcXp2%' '%+Xc, 

cuu 1 = \E ; , cvvis = \EW, db , dchl =\E~A$ < 1 6*> , dim = \EE, dl 1 =\E~B$ < 3*> , 
ed = \E C$ < 1 6*> , el=\E~u* < 16> , eo , f lash = \Ek$ < 2 0>\EK , ht = \t$<8>, 
il1=\E~R$<3»>, in, ind=~J, . ind = ~ J$<9> , ip=$<l6*>, 
is 2 = \EU\Ef \E7\E5\E8\E1\ENH\EK\E\20 0\EoSA200\Eo\47\E, 
kbs= A h, kcub1=\E>, kcud1=\E<, kcuf1=\E=, kcuu1=\E;, 
kf 1 =\E5 , kf 2=\E6 , kf 3=\E7 , khome=\E?, 

lines#24, mir, pb#9600, prot=\EI, rep=\Er%p 1 Xc%p2X ' 'X+%c*<.2*>, 

rev=\ED , rmcup=\Ev $<6>\Ep\r\n, rmir=\E\200, rmkx=\Ex, 
rmso=\Ed\Ee, rmul=\Eg, rmul=\Eg, sgr0=\EN\200 , 
smcup=\EU\Ev 8p\Ep\r, smir=\E'P, smkx=\EX, smso=\EE\ED, 
smul=\EG, tabs, ill, vt#8 , xenl, 


Entries may continue onto multiple lines by placing white space at the begin- 
ning of each line except the first. Comments may be included on lines begin- 
mng with “#”. Capabilities in terminfo are of three types: Boolean capabilities 
which indicate that the terminal has some particular feature, numeric capabili- 
ties giving the size of the terminal or the size of particular delays, and string 
capabilities, which give a sequence which can be used to perform particular ter- 
minal operations. 


Types of Capabilities 

All capabilities have names. For instance, the fact that the Concept has 
automatic margins (i.e., an automatic return and linefeed when the end of a 
fine is reached) is indicated by the capability am. Hence the description of the 
Concept includes am. Numeric capabilities are followed by the character *#’ 
and then the value. Thus cols, which indicates the number of columns the ter- 
minal has, gives the value ‘80’ for the Concept. 

Finally, string valued capabilities, such as el (clear to end of line sequence) are 
gwen by the two-character code, an *=’, and then a string ending at the next 
following \\ A delay in milliseconds may appear anywhere in such a capabil- 
ity, enclosed in $<„> brackets, as in el=\EK$<3>, and padding characters 
are supplied by tputs to provide this delay. The delay can be either a number 
e.g., ‘20’, or a number followed by an **’, i.e., ‘3*’. A ‘*’ indicates that the 
padding required is proportional to the number of lines affected by the opera- 
tion, and the amount given is the per-affected-unit padding required (In the 
case of insert character, the factor is still the number of lines affected. This is 
always one unless the terminal has xenl and the software uses it.) When a ‘*’ is 
specified, it is sometimes useful to give a delay of the form ‘3.5’ to specify a 
delay per unit to tenths of milliseconds. (Only one decimal place is allowed.) 
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A number of escape sequences are provided in the string valued capabilities for 
easy encoding of characters there. Both \E and \e map to an ESCAPE charac- 
ter, “x maps to a control-x for any appropriate x, and the sequences \n \1 \r \t 
\b \f \s give a newline, linefeed, return, tab, backspace, formfeed, and space. 
Other escapes include \* for “, \\ for \, \, for comma, \: for :, and \0 for null. 
(\0 will produce \200, which does not terminate a string but behaves as a null 
character on most terminals.) Finally, characters may be given as three octal 
digits after a \. 

Sometimes individual capabilities must be commented out. To do this, put a 
period before the capability name. For example, see the second ind in the 
example above. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective 
way to prepare a terminal description is by imitating the description of a simi- 
lar terminal in terminfo and to build up a description gradually, using partial 
descriptions with vi to check that they are correct. Be aware that a very 
unusual terminal may expose deficiencies in the ability of the terminfo file to 
describe it or bugs in vi. To easily test a new terminal description you can set 
the environment variable TERMINFO to a pathname of a directory containing 
the compiled description you are working on and programs will look there 
rather than in lusrlliblterminfo. To get the padding for insert line right (if the 
terminal manufacturer did not document it) a severe test is to edit /etc/passwd 
at 9600 baud, delete 16 or so lines from the middle of the screen, then hit the 
‘u’ key several times quickly. If the terminal messes up, more padding is usu- 
ally needed. A similar test can be used for insert character. 

Basic Capabilities 

The number of columns on each line for the terminal is given by the cols 
numeric capability. If the terminal is a CRT, then the number of lines on the 
screen is given by the lines capability. If the terminal wraps around to the 
beginning of the next line when it reaches the right margin, then it should have 
the am capability. If the terminal can clear its screen, leaving the cursor in the 
home position, then this is given by the clear string capability. If the terminal 
overstrikes (rather than clearing a position when a character is struck over) 
then it should have the os capability. If the terminal is a printing terminal, 
with no soft copy unit, give it both he and os. (os applies to storage scope ter- 
minals, such as TEKTRONIX 4010 series, as well as hard copy and APL termi- 
nals.) If there is a code to move the cursor to the left edge of the current row, 
give this as cr. (Normally this will be carriage return, control M.) If there is a 
code to produce an audible signal (bell, beep, etc) give this as bel. 

If there is a code to move the cursor one position to the left (such as back- 
space) that capability should be given as cubl. Similarly, codes to move to the 
right, up, and down should be given as cufl, cuul, and cudl. These local cursor 
motions should not alter the text they pass over, for example, you would not 
normally use ‘cufl= ’ because the space would erase the character moved over. 

A very important point here is that the local cursor motions encoded in ter- 
minfo are undefined at the left and top edges of a CRT terminal. Programs 
should never attempt to backspace around the left edge, unless bw is given, and 
never attempt to go up locally off the top. In order to scroll text up, a program 
will go to the bottom left corner of the screen and send the ind (index) string. 

To scroll text down, a program goes to the top left corner of the screen and 
sends the ri (reverse index) string. The strings ind and ri are undefined when 
not on their respective corners of the screen. 
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Parameterized versions of the scrolling sequences are indn and rin which have 
the same semantics as ind and ri except that they take one parameter, and 
scroll that many lines. They are also undefined except at the appropriate edge 
of the screen. 

The am capability tells whether the cursor sticks at the right edge of the screen 
when text is output, but this does not necessarily apply to a cufl from the last 
column. The only local motion which is defined from the left edge is if bw is 
given, then a cubl from the left edge will move to the right edge of the previ- 
ous row. If bw is not given, the effect is undefined. This is useful for drawing 
a box around the edge of the screen, for example. If the terminal has switch 
selectable automatic margins, the terminfo file usually assumes that this is on; 
i.e., am. If the terminal has a command which moves to the first column of the 
next line, that command can be given as nel (newline). It does not matter if 
the command clears the remainder of the current line, so if the terminal has no 
cr and If it may still be possible to craft a working nel out of one or both of 
them. 

These capabilities suffice to describe hardcopy and glass-tty terminals. Thus 
the model 33 teletype is described as 

33 !tty33! tty! model 33 teletype, 

k®l~ G, cols#72 , cr = M, cudl = A J , tic, ind=~J, os, 
while the Lear Siegler ADM— 3 is described as 
adm3 ! 3 ! lsi adm3 , 

am, bel^G, clear^Z, cols#80, cr = A M, cub1 = A H, cud1 = A J, 
ind= , 'J, lines#24, 

Parameterized Strings 

Cursor addressing and other strings requiring parameters in the terminal are 
described by a parameterized string capability, with printf { 3S) like escapes %x 
in it. For example, to address the cursor, the cup capability is given, using two 
parameters, the row and column to address to. (Rows and columns are num- 
bered from zero and refer to the physical screen visible to the user, not to any 
unseen memory.) If the terminal has memory relative cursor addressing, that 
can be indicated by mrcup. 

The parameter mechanism uses a stack and special % codes to manipulate it. 
Typically a sequence will push one of the parameters onto the stack and then 
print it in some format. Often more complex operations are necessary. 

The % encodings have the following meanings: 


%% 

outputs '%’ 

%d 

print popO as in printf 

%2d 

print popO like %2d 

%3d 

print popO like %3d 

%02d 


%03d 

as in printf 

%c 

print popO gives %c 

%s 

print popO gives %s 

%p[ 1 -9] 

push ith parm 

%P[a-z] 

set variable [a-z] to popO 

%g[a-z] 

get variable [a-z] and push it 

%’c’ 

char constant c 

%{nn) 

integer constant nn 

%+ %■ %* %/ %m 

arithmetic (%m is mod): push (popO op popO) 
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%& %\ %- 
%= %> %< 
%\ %- 

%i 


bit operations: push (pop 0 op popO) 
logical operations: push (pop 0 op popO) 
unary operations push(op popO) 
add 1 to first two parms (for ANSI terminals) 


%? expr %t thenpart %e elsepart %; 

if-then-else, %e elsepart is optional, 
else-ifs are possible ala Algol 68: 

%? Cj %t b, %e Cj %t b 2 %e Cj %t b^ %e %t b^ %e %; 
Cj are conditions, N are bodies. 

Binary operations are in postfix form with the operands in the usual order. 
That is, to get x-5 one would use "%gx%(5}%-". 

Consider the Flewlett-Packard 2645, which, to get to row 3 and column 12, 
needs to be sent \E&al2c03Y padded for 6 milliseconds. Note that the order 
of the rows and columns is inverted here, and that the row and column are 
printed as two digits. Thus its cup capability is cup=6\E&%p2%2dc%pl%2dY. 

The Microterm ACT-IV needs the current row and column sent preceded by a 
“T, with the row and column simply encoded in binary, cup=“T%pl%c%p2%c. 
Terminals which use %c need to be able to backspace the cursor (cubl), and to 
move the cursor up one line on the screen (cuul). This is necessary because it 
is not always safe to transmit \n "D and \r, as the system may change or dis- 
card them. (The library routines dealing with terminfo set tty modes so that 
tabs are never expanded, so \t is safe to send. This turns out to be essential for 
the Ann Arbor 4080.) 

A final example is the LSI ADM-3a, which uses row and column offset by a 
blank character, thus cup=\E=%pl%’ ’%+%c%p2%’ ’%+%c. After sending 
‘\E=’, this pushes the first parameter, pushes the ASCII value for a space (32), 
adds them (pushing the sum on the stack in place of the two previous values) 
and outputs that value as a character. Then the same is done for the second 
parameter. More complex arithmetic is possible using the stack. 

If the terminal has row or column absolute cursor addressing, these can be 
given as single parameter capabilities hpa (horizontal position absolute) and vpa 
(vertical position absolute) . Sometimes these are shorter than the more general 
two parameter sequence (as with the hp2645) and can be used in preference to 
cup . If there are parameterized local motions (e.g., move n spaces to the right) 
these can be given as cud, cub, cuf, and cuu with a single parameter indicating 
how many spaces to move. These are primarily useful if the terminal does not 
have cup, such as the TEKTRONIX 4025. 

Cursor Motions 

If the terminal has a fast way to home the cursor (to very upper left corner of 
screen) then this can be given as home; similarly a fast way of getting to the 
lower left-hand corner can be given as 11; this may involve going up with cuul 
from the home position, but a program should never do this itself (unless II 
does) because it can make no assumption about the effect of moving up from 
the home position. Note that the home position is the same as addressing to 
(0,0): to the top left corner of the screen, not of memory. (Thus, the \EH 
sequence on Hewlett-Packard terminals cannot be used for home.) 

Area Clears 

If the terminal can clear from the current position to the end of the line, leav- 
ing the cursor where it is, this should be given as el. If the terminal can clear 
from the current position to the end of the display, then this should be given as 
ed. Ed is only defined from the first column of a line. (Thus, it can be simu- 
lated by a request to delete a large number of lines, if a true ed is not 
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available.) 

Insert/delete line 

If the terminal can open a new blank line before the line where the cursor is, 
this should be given as ill; this is done only from the first position of a line. 
The cursor must then appear on the newly blank line. If the terminal can 
delete the line which the cursor is on, then this should be given as dll; this is 
done only from the first position on the line to be deleted. Versions of ill and 
dll which take a single parameter and insert or delete that many lines can be 
given as il and dl. If the terminal has a settable scrolling region (like the 
vt 1 00) the command to set this can be described with the csr capability, which 
takes two parameters: the top and bottom lines of the scrolling region. The 
cursor position is, alas, undefined after using this command. It is possible to 
get the effect of insert or delete line using this command - the sc and rc (save 
and restore cursor) commands are also useful. Inserting lines at the top or bot- 
tom of the screen can also be done using ri or ind on many terminals without a 
true insert/delete line, and is often faster even on terminals with those features. 

If the terminal has the ability to define a window as part of memory, which all 
commands affect, it should be given as the parameterized string wind. The four 
parameters are the starting and ending lines in memory and the starting and 
ending columns in memory, in that order. 

If the terminal can retain display memory above, then the da capability should 
be given; if display memory can be retained below, then db should be given. 
These indicate that deleting a line or scrolling may bring non-blank lines up 
from below or that scrolling back with ri may bring down non-blank lines. 

Insert/Delete Character 

There are two basic kinds of intelligent terminals with respect to insert/delete 
character which can be described using terminfo. The most common 
insert/delete character operations affect only the characters on the current line 
and shift characters off the end of the line rigidly. Other terminals, such as the 
Concept 100 and the Perkin Elmer Owl, make a distinction between typed and 
untyped blanks on the screen, shifting upon an insert or delete only to an 
untyped blank on the screen which is either eliminated, or expanded to two 
untyped blanks. You can determine the kind of terminal you have by clearing 
the screen and then typing text separated by cursor motions. Type abc def 
using local cursor motions (not spaces) between the abc and the def. Then 
position the cursor before the abc and put the terminal in insert mode. If typ- 
ing characters causes the rest of the line to shift rigidly and characters to fall 
off the end, then your terminal does not distinguish between blanks and 
untyped positions. If the abc shifts over to the def which then move together 
around the end of the current line and onto the next as you insert, you have the 
second type of terminal, and should give the capability in, which stands for 
insert null. While these are two logically separate attributes (one line vs. mul- 
tiline insert mode, and special treatment of untyped spaces) we have seen no 
terminals whose insert mode cannot be described with the single attribute. 

Terminfo can describe both terminals which have an insert mode, and terminals 
which send a simple sequence to open a blank position on the current line. 
Give as smir the sequence to get into insert mode. Give as rmir the sequence to 
leave insert mode. Now give as ichl any sequence needed to be sent just before 
sending the character to be inserted. Most terminals with a true insert mode 
will not give ichl; terminals which send a sequence to open a screen position 
should give it here. (If your terminal has both, insert mode is usually prefer- 
able to ichl. Do not give both unless the terminal actually requires both to be 
used in combination.) If post insert padding is needed, give this as a number of 
milliseconds in ip (a string option). Any other sequence which may need to be 
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sent after an insert of a single character may also be given in ip. If your termi- 
nal needs both to be placed into an ‘insert mode’ and a special code to precede 
each inserted character, then both smir/rmir and ichl can be given, and both 
will be used. The ich capability, with one parameter, n, will repeat the effects 
of ichl n times. 

It is occasionally necessary to move around while in insert mode to delete char- 
acters on the same line (e.g., if there is a tab after the insertion position). If 
your terminal allows motion while in insert mode you can give the capability 
mir to speed up inserting in this case. Omitting mir will affect only speed. 
Some terminals (notably Datamedia’s) must not have mir because of the way 
their insert mode works. 

Finally, you can specify dchl to delete a single character, dch with one parame- 
ter, n, to delete n characters, and delete mode by giving smdc and rmdc to 
enter and exit delete mode (any mode the terminal needs to be placed in for 
dchl to work). 

A command to erase n characters (equivalent to outputting n blanks without 
moving the cursor) can be given as ech with one parameter. 

Highlighting, Underlining, and Visible Bells 

If your terminal has one or more kinds of display attributes, these can be 
represented in a number of different ways. You should choose one display form 
as standout mode, representing a good, high contrast, easy-on-the-eyes, format 
for highlighting error messages and other attention getters. (If you have a 
choice, reverse video plus half-bright is good, or reverse video alone.) The 
sequences to enter and exit standout mode are given as smso and rmso, respec- 
tively. If the code to change into or out of standout mode leaves one or even 
two blank spaces on the screen, as the TVI 912 and Teleray 1061 do, then xmc 
should be given to tell how many spaces are left. 

Codes to begin underlining and end underlining can be given as smut and rmul 
respectively. If the terminal has a code to underline the current character and 
move the cursor one space to the right, such as the Microterm Mime, this can 
be given as uc. 

Other capabilities to enter various highlighting modes include blink (blinking) 
bold (bold or extra bright) dim (dim or half-bright) invis (blanking or invisible 
text) prot (protected) rev (reverse video) sgrO (turn off all attribute modes) 
smacs (enter alternate character set mode) and rmacs (exit alternate character 
set mode). Turning on any of these modes singly may or may not turn off 
other modes. 

If there is a sequence to set arbitrary combinations of modes, this should be 
given as sgr (set attributes), taking 9 parameters. Each parameter is either 0 
or 1, as the corresponding attribute is on or off. The 9 parameters are, in 
order: standout, underline, reverse, blink, dim, bold, blank, protect, alternate 
character set. Not all modes need be supported by sgr, only those for which 
corresponding separate attribute commands exist. 

Terminals with the “magic cookie” glitch (xmc) deposit special “cookies” when 
they receive mode-setting sequences, which affect the display algorithm rather 
than having extra bits for each character. Some terminals, such as the 
Hewlett-Packard 2621, automatically leave standout mode when they move to a 
new line or the cursor is addressed. Programs using standout mode should exit 
standout mode before moving the cursor or sending a newline, unless the msgr 
capability, asserting that it is safe to move in standout mode, is present. 

If the terminal has a way of flashing the screen to indicate an error quietly (a 
bell replacement) then this can be given as flash; it must not move the cursor. 
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If the cursor needs to be made more visible than normal when it is not on the 
bottom line (to make, for example, a non-blinking underline into an easier to 
find block or blinking underline) give this sequence as cvvis. If there is a way 
to make the cursor completely invisible, give that as civis. The capability 
cnorm should be given which undoes the effects of both of these modes. 

If the terminal needs to be in a special mode when running a program that uses 
these capabilities, the codes to enter and exit this mode can be given as smcup 
and rmcup. This arises, for example, from terminals like the Concept with 
more than one page of memory. If the terminal has only memory relative cur- 
sor addressing and not screen relative cursor addressing, a one screen-sized win- 
dow must be fixed into the terminal for cursor addressing to work properly. 
This is also used for the TEKTRONIX 4025, where smcup sets the command 
character to be the one used by terminfo. 

If your terminal correctly generates underlined characters (with no special 
codes needed) even though it does not overstrike, then you should give the 
capability ul. If overstrikes are erasable with a blank, then this should be indi- 
cated by giving eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are pressed, 
this information can be given. Note that it is not possible to handle terminals 
where the keypad only works in local (this applies, for example, to the 
unshifted Hewlett-Packard 2621 keys). If the keypad can be set to transmit or 
not transmit, give these codes as smkx and rmkx. Otherwise the keypad is 
assumed to always transmit. The codes sent by the left arrow, right arrow, up 
arrow, down arrow, and home keys can be given as kcubl, kcufl, kcuul, kcudl, 
and khome respectively. If there are function keys such as fO, fl, ..., flO, the 
codes they send can be given as kfO, kfl, kflO. If these keys have labels 
other than the default fO through flO, the labels can be given as IfO, lfl, 

If 10. The codes transmitted by certain other special keys can be given: kll 
(home down), kbs (backspace), ktbc (clear all tabs), kctab (clear the tab stop 
in this column), kclr (clear screen or erase key), kdchl (delete character), kdll 
(delete line), krmir (exit insert mode), kel (clear to end of line), ked (clear to 
end of screen), kichl (insert character or enter insert mode), kill (insert line), 
knp (next page), kpp (previous page), kind (scroll forward/down), kri (scroll 
backward/up), khts (set a tab stop in this column). In addition, if the keypad 
has a 3 by 3 array of keys including the four arrow keys, the other five keys 
can be given as kal, ka3, kb2, kcl, and kc3. These keys are useful when the 
effects of a 3 by 3 directional pad are needed. 

Tabs and Initialization 

If the terminal has hardware tabs, the command to advance to the next tab 
stop can be given as ht (usually control I). A “backtab” command which 
moves leftward to the next tab stop can be given as cbt. By convention, if the 
teletype modes indicate that tabs are being expanded by the computer rather 
than being sent to the terminal, programs should not use ht or cbt even if they 
are present, since the user may not have the tab stops properly set. If the ter- 
minal has hardware tabs which are initially set every n spaces when the termi- 
nal is powered up, the numeric parameter it is given, showing the number of 
spaces the tabs are set to. This is normally used by the tset command to deter- 
mine whether to set the mode for hardware tab expansion, and whether to set 
the tab stops. If the terminal has tab stops that can be saved in nonvolatile 
memory, the terminfo description can assume that they are properly set. 

Other capabilities include isl, is2, and is3, initialization strings for the termi- 
nal, iprog, the path name of a program to be run to initialize the terminal, and 
if, the name of a file containing long initialization strings. These strings are 
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expected to set the terminal into modes consistent with the rest of the terminfo 
description. They are normally sent to the terminal, by the tset program, each 
time the user logs in. They will be printed in the following order: isl; is2; set- 
ting tabs using tbc and hts; if; running the program iprog; and finally is3. Most 
initialization is done with is2. Special terminal modes can be set up without 
duplicating strings by putting the common sequences in is2 and special cases in 
isl and is3. A pair of sequences that does a harder reset from a totally unk- 
nown state can be analogously given as rsl, rs2, rf, and rs3, analogous to is2 
and if. These strings are output by the reset program, which is used when the 
terminal gets into a wedged state. Commands are normally placed in rs2 and 
rf only if they produce annoying effects on the screen and are not necessary 
when logging in. For example, the command to set the vtlOO into 80-column 
mode would normally be part of is2, but it causes an annoying glitch of the 
screen and is not normally needed since the terminal is usually already in 80 
column mode. 

If there are commands to set and clear tab stops, they can be given as tbc 
(clear all tab stops) and hts (set a tab stop in the current column of every 
row). If a more complex sequence is needed to set the tabs than can be 
described by this, the sequence can be placed in is2 or if. 

Delays 

Certain capabilities control padding in the teletype driver. These are primarily 
needed by hard copy terminals, and are used by the tset program to set teletype 
modes appropriately. Delays embedded in the capabilities cr, ind, cubl, IT, and 
tab will cause the appropriate delay bits to be set in the teletype driver. If pb 
(padding baud rate) is given, these values can be ignored at baud rates below 
the value of pb. 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then this 
can be given as pad. Only the first character of the pad string is used. 

If the terminal has an extra “status line” that is not normally used by software, 
this fact can be indicated. If the status line is viewed as an extra line below 
the bottom line, into which one can cursor address normally (such as the 
Heathkit hl9’s 25th line, or the 24th line of a vtlOO which is set to a 23-line 
scrolling region), the capability hs should be given. Special strings to go to the 
beginning of the status line and to return from the status line can be given as 
tsl and fsl. (fsl must leave the cursor position in the same place it was before 
tsl. If necessary, the sc and rc strings can be included in tsl and fsl to get this 
effect.) The parameter tsl takes one parameter, which is the column number of 
the status line the cursor is to be moved to. If escape sequences and other spe- 
cial commands, such as tab, work while in the status line, the flag eslok can be 
given. A string which turns off the status line (or otherwise erases its contents) 
should be given as dsl. If the terminal has commands to save and restore the 
position of the cursor, give them as sc and rc. The status line is normally 
assumed to be the same width as the rest of the screen, e.g., cols. If the status 
line is a different width (possibly because the terminal does not allow an entire 
line to be loaded) the width, in columns, can be indicated with the numeric 
parameter wsl. 

If the terminal can move up or down half a line, this can be indicated with hu 
(half-line up) and hd (half-line down). This is primarily useful for superscripts 
and subscripts on hardcopy terminals. If a hardcopy terminal can eject to the 
next page (form feed), give this as ff (usually control L). 

If there is a command to repeat a given character a given number of times (to 
save time transmitting a large number of identical characters) this can be 
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indicated with the parameterized string rep. The first parameter is the charac- 
ter to be repeated and the second is the number of times to repeat it. Thus, 
tparm (repea tchar, ’x’, 10) is the same as ‘xxxxxxxxxx’. 

If the terminal has a settable command character, such as the TEKTRONIX 
4025, this can be indicated with cmdch. A prototype command character is 
chosen which is used in all capabilities. This character is given in the cmdch 
capability to identify it. The following convention is supported on some UNIX 
systems: The environment is to be searched for a CC variable, and if found, all 
occurrences of the prototype character are replaced with the character in the 
environment variable. 

Terminal descriptions that do not represent a specific kind of known terminal, 
such as switch, dialup, patch, and network, should include the gn (generic) 
capability so that programs can complain that they do not know how to talk to 
the terminal. (This capability does not apply to virtual terminal descriptions 
for which the escape sequences are known.) 

If the terminal uses xon/xoff handshaking for flow control, give xon. Padding 
information should still be included so that routines can make better decisions 
about costs, but actual pad characters will not be transmitted. 

If the terminal has a “meta key” which acts as a shift key, setting the 8th bit 
of any character transmitted, this fact can be indicated with km. Otherwise, 
software will assume that the 8th bit is parity and it will usually be cleared. If 
strings exist to turn this meta mode on and off, they can be given as smm 
and rmm. 

If the terminal has more lines of memory than will fit on the screen at once, 
the number of lines of memory can be indicated with lm. A value of lm#0 
indicates that the number of lines is not fixed, but that there is still more 
memory than fits on the screen. 

If the terminal is one of those supported by the UNIX system virtual terminal 
protocol, the terminal number can be given as vt. 

Media copy strings which control an auxiliary printer connected to the terminal 
can be given as mcO: print the contents of the screen, mc4: turn off the printer, 
and mc5: turn on the printer. When the printer is on, all text sent to the termi- 
nal will be sent to the printer. It is undefined whether the text is also displayed 
on the terminal screen when the printer is on. A variation mc5p takes one 
parameter, and leaves the printer on for as many characters as the value of the 
parameter, then turns the printer off. The parameter should not exceed 255. 
All text, including mc4, is transparently passed to the printer while an mc5p is 
in effect. 

Strings to program function keys can be given as pfkey, pfloc, and pfx. Each of 
these strings takes two parameters: the function key number to program (from 
0 to 10) and the string to program it with. Function key numbers out of this 
range may program undefined keys in a terminal dependent manner. The 
difference between the capabilities is that pfkey causes pressing the given key 
to be the same as the user typing the given string; pfloc causes the string to be 
executed by the terminal in local; and pfx causes the string to be transmitted to 
the computer. 
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Glitches and Braindamage 

Hazeltine terminals, which do not allow characters to be displayed should 
indicate hz. 

Terminals which ignore a linefeed immediately after an am wrap, such as the 
Concept and vtlOO, should indicate xenl. 

If el is required to get rid of standout (instead of merely writing normal text on 
top of it), xhp should be given. 

Teleray terminals, where tabs turn all characters moved over to blanks, should 
indicate xt (destructive tabs). This glitch is also taken to mean that it is not 
possible to position the cursor on top of a “magic cookie”, that to erase stan- 
dout mode it is instead necessary to use delete and insert line. 

The Beehive Superbee, which is unable to correctly transmit the escape or con- 
trol C characters, has xsb, indicating that the fl key is used for escape and f2 
for control C. (Only certain Superbees have this problem, depending on the 
ROM.) 

Other specific terminal problems may be corrected by adding more capabilities 
of the form xx. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being just like the 
other with certain exceptions. The string capability use can be given with the 
name of the similar terminal. The capabilities given before use override those 
in the terminal type invoked by use. A capability can be cancelled by placing 
xx@ to the left of the capability definition, where xx is the capability. For 
example, the entry 

2621-nl, smkx@, rmkx@, use=2621, 

defines a 2621-nl that does not have the smkx or rmkx capabilities, and hence 
does not turn on the function key labels when in visual mode. This is useful for 
different modes for a terminal, or for different user preferences. 

FILES 

/usr/lib/terminfo/?/* files containing terminal descriptions 
SEE ALSO 

curses(3X), printf(3S), term(5). 

tic(lM) in the UNIX System V Administrator Reference Manual. 
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NAME 

utmp, wtmp — utmp and wtmp entry formats 
SYNOPSIS 

#include <sys/types.h> 

#include <utmp.h> 

DESCRIPTION 

These files, which hold user and accounting information for such commands as 
who( 1), write (l), and login(l), have the following structure as defined by 

<utmp.h>: 

#define UTMPFILE 7etc/utmp" 

#define WTMPFILE 7etc/wtmp" 

#define ut_name ut_user 

struct utmp { 

char ut_user[8]; /» User login name */ 

char ut_id[4]; /* /etc/inittab id (usually line #) */ 

char ut line[12]; /* device name (console, lnxx) »/ 

short ut_pid; /* process id »/ 

short ut type; /* type of entry */ 

struct exit_status { 

short e_termination; /* Process termination status »/ 

short e_exit; /* Process exit status */ 

} ut exit; /* The exit status of a process 

• marked as DEAD PROCESS. */ 
time_t ut time; /» time entry was made »/ 


/» Definitions for ut_type */ 

#define EMPTY 0 

#define RUN LVL 1 

#define BOOT TIME 2 

#define OLD TIME 3 

#define NEW TIME 4 

#define INIT PROCESS 5 /* Process spawned by "init" */ 

#define LOGIN PROCESS 6 /» A "getty" process waiting for login »/ 

#define USER_PROCESS 7 /* A user process */ 

#define DEAD PROCESS 8 

#define ACCOUNTING 9 

#define UTMAXTYPE ACCOUNTING /• Largest legal value of ut type */ 

/* Special strings or formats used in the "utjine" field when */ 

/* accounting for something other than a process */ 

/* No string for the utjine field can be more than 1 1 chars + */ 

/* a NULL in length */ 

#define RUNLVL MSG "run-level %c" 

#define BOOT MSG "system boot" 

#define OTIME MSG "old time" 

#define NTIME MSG "new time" 
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FILES 

/ usr/include/utmp.h 

/etc/utmp 

/etc/wtmp 

SEE ALSO 

getut(3C). 

login(l), who(l), write(l) in the UNIX System V User Reference Manual. 
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NAME 

intro — introduction to miscellany 
DESCRIPTION 

This section describes miscellaneous facilities such as macro packages, charac- 
ter set tables, etc. 
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NAME 

ascii — map of ASCII character set 

SYNOPSIS 

cat /usr/pub/ascii 

DESCRIPTION 

Ascii is a map of the ASCII character set, giving both octal and hexadecimal 
equivalents of each character, to be printed as needed. It contains: 


000 

nul 

| 00 1 

soh 

| 002 

s tx 

| 003 

etx 

| 004 

eot 

| 005 

enc 

1 006 

ack 

o 

o 

-4 

be 1 

010 

bs 

1 01 1 

ht 

1 012 

n 1 

j 01 3 

vt 

j 014 

np 

j 015 

cr 

| 01 6 

so 

1 017 

s i 

020 

d 1 e 

j 021 

del 

| 022 

dc2 

| 023 

dc3 

j 024 

dc^ 

| 025 

nak 

j 026 

syn 

j 027 

etb 

030 

can 

j 03 1 

em 

j 032 

sub 

j 033 

esc 

j 034 

f s 

1 035 

gs 

j 036 

rs 

j 037 

us 

040 

sp 

| 04 1 

! 

j 042 

" 

j 043 

# 

j 044 

$ 

| 045 

% 

1 046 

& 

1 047 

r 

050 

( 

j 051 

) 

| 052 

* 

1 053 

+ 

1 054 

j 

j 055 

- 

1 056 


1 057 

/ 

060 

0 

1 061 

1 

j 062 

2 

| 063 

3 

j 064 

4 

j 065 

5 

1 066 

6 

1 067 

1 

070 

8 

| 07 1 

9 

j 072 


| 073 

J 

| 074 

< 

j 075 


j 076 

> 

1 077 

? 

100 

@ 

| 101 

A 

| 102 

B 

1 103 

C 

| 104 

D 

| 105 

I 

| 106 

F 

| 107 

G 

110 

H 

| 111 

I 

| 112 

J 

j 1 13 

K 

| 114 

L 

1 115 

M 

j 1 1 6 

N 

j 117 

O 

120 

P 

| 121 

Q 

j 122 

R 

| 123 

S 

| 124 

T 

| 125 

U 

| 126 

V 

j 1 27 

W 

130 

X 

1 131 

Y 

| 132 

Z 

| 133 

( 

| 134 

\ 

| 135 

] 

j 1 36 

* 

| 137 


140 


j 141 

a 

j 142 

b 

| 143 

c 

| 144 

d 

j 145 

e 

| 146 

f 

| 147 

g 

150 

h 

j 151 

i 

| 152 

j 

j 153 

k 

j 1 54 

1 

1 155 

m 

| 156 

n 

j 157 

0 

160 

P 

j 161 

q 

| 162 

r 

| 163 

s 

| 164 

t 

I 165 

u 

| 166 

V 

1 167 

w 

170 

X 

1 171 

y 

| 172 

z 

1 1 73 

{ 

j 174 

1 

j 175 

) 

j 176 

' 

j 177 

de 1 

00 

nu 1 

1 01 

soh 

I 02 

stx 

1 03 

etx 

| 04 

eot 

1 05 

enq 

| 06 

ack 

1 07 

be 1 

08 

bs 

| 09 

ht 

j 0a 

n 1 

| 0b 

vt 

| 0c 

np 

j Od 

cr 

| Oe 

so 

| Of 

s i 

10 

dl e 

1 11 

del 

1 12 

dc2 

j 13 

dc3 

| 14 

dc4 

1 15 

nak 

1 16 

syn 

j 17 

etb 

18 

can 

1 19 

em 

1 la 

sub 

1 lb 

esc 

1 1 c 

f s 

1 Id 

gs 

1 le 

r s 

1 If 

us 

20 

sp 

j 21 

i 

| 22 

" 

1 23 

# 

1 24 

$ 

I 25 

% 

| 26 

& 

j 27 

r 

28 

( 

| 29 

j 

1 2a 

* 

1 2b 

+ 

1 2c 


1 2d 

— 

| 2e 


i 2f 

/ 

30 

0 

j 31 

1 

1 32 

2 

j 33 

3 

1 34 

4 

j 35 

5 

1 36 

6 

j 37 

7 

38 

8 

j 39 

9 

1 3a 


i 3b 

J 

j 3c 

< 

| 3d 

= 

1 3e 

> 

1 3f 

? 

40 

@ 

1 41 

A 

1 42 

B 

i 43 

C 

| 44 

D 

j 45 

E 

| 46 

F 

j 47 

G 

48 

H 

| 49 

I 

| 4a 

J 

| 4b 

K 

j 4c 

L 

| 4d 

M 

| 4e 

N 

| 4f 

O 

50 

P 

1 51 

Q 

1 52 

R 

i 53 

S 

| 54 

T 

j 55 

U 

1 56 

V 

1 57 

W 

58 

X 

j 59 

Y 

1 5a 

Z 

| 5b 

[ 

1 5c 

\ 

1 5d 

1 

1 5e 


j 5f 


60 


j 61 

a 

1 62 

b 

| 63 

c 

| 64 

d 

j 65 

e 

| 66 

f 

1 67 

g 

68 

h 

| 69 

i 

| 6a 

j 

| 6b 

k 

| 6c 

1 

| 6d 

m 

| 6e 

n 

j 6f 

0 

70 

P 

j 71 

q 

j 72 

r 

1 73 

s 

j 74 

t 

1 75 

u 

1 76 

V 

| 77 

w 

78 

X 

j 79 

y 

1 7a 

z 

j 7b 

{ 

1 7c 

1 

| 7d 

] 

1 7e 

• 

| 7 f 

de 1 


/usr/pub/ascii 
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NAME 

environ — user environment 
DESCRIPTION 

An array of strings called the “environment” is made available by exec (2) 
when a process begins. By convention, these strings have the form 
name=value”. The following names are used by various commands: 

PATH The sequence of directory prefixes that sMl), time ( 1 ) , nice(l), 
nohup(l), etc., apply in searching for a file known by an incomplete 
path name. The prefixes are separated by colons (:). Logini. 1) sets 

PATH = :/bin:/usr /bin. 

HOME Name of the user’s login directory, set by login (. 1) from the password 
file passwd (4) . 

TERM The kind of terminal for which output is to be prepared. This informa- 
tion is used by commands, such as mm{ 1) or tploti 1G), which may 
exploit special capabilities of that terminal. 

TZ Time zone information. The format is xxxnzzz where xxx is standard 
local time zone abbreviation, n is the difference in hours from GMT, 
and zzz is the abbreviation for the daylight-saving local time zone, if 
any; for example, EST5EDT. 

Further names may be placed in the environment by the export command and 
name=value ’ arguments in .5/1 (l), or by exec (2). It is unwise to conflict with 
certain shell variables that are frequently exported by .profile files- MAIL PSI 
PS2, IFS. 

SEE ALSO 

exec (2). 

env(l), login(l), sh(l), mm(l), nice(l), nohup(l), time(l), tplot(lG) in the 
UNIX System V User Reference Manual. 


- 1 - 



FCNTL(5) 


FCNTL(5) 


NAME 

fcntl — file control options 

SYNOPSIS 

#include <fcntl.h> 

DESCRIPTION 

The fcntl (2) function provides for control over open files. This include file 
describes requests and arguments to fcntl and open (2). 

/* Flag values accessible to open (2) and fcntl (2) */ 

/* (The first three can only be set by open) */ 

#define ORDONLY 0 
#define 0_WR0NLY 1 
#define O RDWR 2 

#define O NDELAY 04 /* Non-blocking I/O »/ 

#define O APPEND 010 /» append (writes guaranteed at the end) */ 

/* Flag values accessible only to open (2) »/ 

#define O CREAT 00400 /» open with file create (uses third open arg)*/ 

#define O TRUNC 01000 /* open with truncation */ 

#define O EXCL 02000 /« exclusive open */ 


/* fcntl (2) requests */ 
#define F DUPFD 
#define F_GETFD 
#define F SETFD 
#define F GETFL 
#define F SETFL 

SEE ALSO 

fcntl (2), open (2). 


0 /* Duplicate fildes »/ 

1 /* Get fildes flags */ 

2 /* Set fildes flags »/ 

3 /* Get file flags */ 

4 /* Set file flags »/ 
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NAME 

math — math functions and constants 

SYNOPSIS 

#include <math.h> 


DESCRIPTION 

This file contains declarations of all the functions in the Math Library 
(described in Section 3M), as well as various functions in the C Library (Sec- 
tion 3C) that return floating-point values. 

It defines the structure and constants used by the matherr(3 M) error-handling 
mechanisms, including the following constant used as an error-return value: 

HUGE The maximum value of a single-precision floating-point 

number. 


The following mathematical constants are defined for user convenience: 


ME 

MLOG2E 

MLOGIOE 

MLN2 

MLN10 

M_PI 

MSQRT2 

MSQRT12 


The base of natural logarithms (e). 

The base-2 logarithm of e. 

The base- 10 logarithm of e. 

The natural logarithm of 2. 

The natural logarithm of 10. 

ir, the ratio of the circumference of a circle to its diame- 
ter. (There are also several fractions of ir, its reciprocal, 
and its square root.) 

The positive square root of 2. 

The positive square root of 1/2. 


For the definitions of various machine-dependent “constants,” see the descrip- 
tion of the <values.h> header file. 


FILES 

/ usr/include/math.h 


SEE ALSO 

intro(3), matherr(3M), values(5). 
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NAME 

prof — profile within a function 

SYNOPSIS 

#define MARK 
#include <prof.h> 

void MARK (name) 

DESCRIPTION 

MARK will introduce a mark called name that will be treated the same as a 
function entry point. Execution of the mark will add to a counter for that mark, 
and program-counter time spent will be accounted to the immediately preced- 
ing mark or to the function if there are no preceding marks within the active 
function. 

Name may be any combination of up to six letters, numbers or underscores. 
Each name in a single compilation must be unique, but may be the same as 
any ordinary program symbol. 

For marks to be effective, the symbol MARK must be defined before the header 
file <profh> is included. This may be defined by a preprocessor directive as 
in the synopsis, or by a command line argument, i.e: 

cc — p — DMARK foo.c 

If MARK is not defined, the MARK{ name) statements may be left in the source 
files containing them and will be ignored. 

EXAMPLE 

In this example, marks can be used to determine how much time is spent in 
each loop. Unless this example is compiled with MARK defined on the com- 
mand line, the marks are ignored. 

#include <prof.h> 

foo( ) 

{ 

int i, j; 


MARK(loopl); 

for (i = 0; i < 2000; i++) { 

} 

MARK(loop2); 

for (j = 0; j < 2000; j++) { 

) 

} 

SEE ALSO 

profil(2), monitor (3C). 

prof(l) in the UNIX System V User Reference Manual. 
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NAME 

regexp - regular expression compile and match routines 
SYNOPSIS 

#define INIT < declarations > 

#define GETCO <getc code> 

#deflne PEEKCO <peekc code> 

#define UNGETC(c) <ungetc code> 

#define RETURN (pointer) < return code> 

#define ERROR (val) < error code> 

#include <regexp.h> 

char 'compile (instring, expbuf, endbuf, eof) 
char *instring, 'expbuf, 'endbuf; 
int eof; 

int step (string, expbuf) 
char 'string, 'expbuf; 

extern char 'loci, »loc2, 'Iocs; 
extern int circf, sed, nbra; 

DESCRIPTION 

This page describes general-purpose regular expression matching routines in the 
form of ed( .1) defined in /usr/include/regexp.h. Programs such as ed( 1), 
sed(l), grep ( 1 ) , £>s(l), expr(l), etc., which perform regular expression match- 
ing use this source file. In this way, only this file need be changed to maintain 
regular expression compatibility. 

The interface to this file is unpleasantly complex. Programs that include this 
, m “ st have the following five macros declared before the 
#include <regexp.h>” statement. These macros are used by the compile 
routine. r 


GETCO 


PEEKCO 


UNGETC(c) 


RETURN ( pointer ) 


ERROR (val) 


Return the value of the next character in the regular 
expression pattern. Successive calls to GETCO should 
return successive characters of the regular expression. 

Return the next character in the regular expression. 
Successive calls to PEEKCO should return the same 
character (which should also be the next character 
returned by GETCO). 

Cause the argument c to be returned by the next call to 
GETCO (and PEEKCO). No more that one character 
of pushback is ever needed and this character is 
guaranteed to be the last character read by GETCO. 
The value of the macro UNGETC(c) is always ignored. 

This macro is used on normal exit of the compile rou- 
tine. The value of the argument pointer is a pointer to 
the character after the last character of the compiled 
regular expression. This is useful to programs which 
have memory allocation to manage. 

This is the abnormal return from the compile routine. 
The argument val is an error number (see table below 
for meanings). This call should never return. 


- 1 - 



REGEXP (5) 


REGEXP (5) 


ERROR 

MEANING 


11 

Range endpoint too large. 


16 

Bad number. 


25 

“\digit” out of range. 


36 

Illegal or missing delimiter. 


41 

No remembered search string. 


42 

\( \) imbalance. 


43 

Too many \(. 

\{\). 

44 

More than 2 numbers given in 

45 

) expected after \. 


46 

First number exceeds second in \{ \J 

49 

[ 1 imbalance. 


50 

Regular expression overflow. 



The syntax of the compile routine is as follows: 
compile (instring, expbuf, endbuf, eof) 

The first parameter instring is never used explicitly by the compile routine but 
is useful for programs that pass down different pointers to input characters. It 
is sometimes used in the INIT declaration (see below). Programs which call 
functions to input characters or have characters in an external array can pass 
down a value of ((char *) 0) for this parameter. 

The next parameter expbuf is a character pointer. It points to the place where 
the compiled regular expression will be placed. 

The parameter endbuf is one more than the highest address where the compiled 
regular expression may be placed. If the compiled expression cannot fit in 
(endbuf— expbuf) bytes, a call to ERROR (50) is made. 

The parameter eof is the character which marks the end of the regular expres- 
sion. For example, in ed( 1), this character is usually a /. 

Each program that includes this file must have a #define statement for INIT. 
This definition will be placed right after the declaration for the function com- 
pile and the opening curly brace ({). It is used for dependent declarations and 
initializations. Most often it is used to set a register variable to point the 
beginning of the regular expression so that this register variable can be used in 
the declarations for GETCO, PEEKCO and UNGETCO. Otherwise it can be 
used to declare external variables that might be used by GETCO, PEEKCO and 
UNGETCO. See the example below of the declarations taken from grep( 1). 

There are other functions in this file which perform actual regular expression 
matching, one of which is the function step. The call to step is as follows: 

step(string, expbuf) 

The first parameter to step is a pointer to a string of characters to be checked 
for a match. This string should be null terminated. 

The second parameter expbuf is the compiled regular expression which was 
obtained by a call of the function compile. 

The function step returns non-zero if the given string matches the regular 
expression, and zero if the expressions do not match. If there is a match, two 
external character pointers are set as a side effect to the call to step. The vari- 
able set in step is loci. This is a pointer to the first character that matched 
the regular expression. The variable loc2, which is set by the function advance, 
points to the character after the last character that matches the regular expres- 
sion. Thus if the regular expression matches the entire line, loci will point to 
the first character of string and loc2 will point to the null at the end of string. 
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Step uses the external variable circf which is set by compile if the regular 
expression begins with “. If this is set then step will try to match the regular 
expression to the beginning of the string only. If more than one regular expres- 
sion is to be compiled before the first is executed the value of circf should be 
saved for each compiled expression and circf should be set to that saved value 
before each call to step. 

The function advance is called from step with the same arguments as step. 
The purpose of step is to step through the string argument and call advance 
until advance returns non-zero indicating a match or until the end of string is 
reached. If one wants to constrain string to the beginning of the line in all 
cases, step need not be called; simply call advance. 

When advance encounters a * or \{ \} sequence in the regular expression, it 
will advance its pointer to the string to be matched as far as possible and will 
recursively call itself trying to match the rest of the string to the rest of the 
regular expression. As long as there is no match, advance will back up along 
the string until it finds a match or reaches the point in the string that initially 
matched the * or \{ \}. It is sometimes desirable to stop this backing up before 
the initial point in the string is reached. If the external character pointer Iocs 
is equal to the point in the string at sometime during the backing up process, 
advance will break out of the loop that backs up and will return zero. This is 
used by ed( 1) and sed(\) for substitutions done globally (not just the first 
occurrence, but the whole line) so, for example, expressions like s/y*//g do not 
loop forever. 


The additional external variables sed and nbra are used for special purposes. 
EXAMPLES 

The following is an example of how the regular expression macros and calls 
look from grep ( 1 ) : 


#define INIT 
#define GETCO 
#define PEEKCO 
#define UNGETC(c) 
#define RETURN (c) 
#define ERROR (c) 

#include <regexp.h> 


register char *sp = instring; 
(*sp++) 

(*sp) 

( sp) 

return; 

regerrO 


(void) compile (*argv, expbuf, &expbuf[ESIZE], \0'); 


if (stepOinebuf, expbuf)) 

succeed ( ) ; 

FILES 

/usr/include/regexp.h 
SEE ALSO 

bs(l), ed(l), expr(l), grep(l), sed(l) in the UNIX System V User Reference 
Manual. 

BUGS 

The handling of circf is kludgy. 

The actual code is probably easier to understand than this manual page. 
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NAME 

stat — data returned by stat system call 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/stat.h> 

DESCRIPTION 

The system calls stat and fstat return data whose structure is defined by this 
include file. The encoding of the field stjnode is defined in this file also. 

/* 

* Structure of the result of stat 
*/ 


struct 

stat 


t 

devt 

st_dev; 


ino_t 

stino; 


ushort 

stmode; 


short 

st_nlink; 


ushort 

st_uid; 


ushort 

stjgid; 


devt 

st_rdev; 


offt 

st_size; 


timet 

statime; 


timet 

st_mtime; 

}; 

time_t 

st_ctime; 

#define 

S_IFMT 

0170000 

#define 

SIFDIR 

0040000 

#define 

SIFCHR 

0020000 

#define 

SIFBLK 

0060000 

#define 

S IFREG 

0100000 

#define 

SJFIFO 

0010000 

#define 

SISUID 

04000 

#define 

S ISGID 

02000 

#define 

SISVTX 

01000 

#define 

S IREAD 

00400 

#define 

S IWRITE 00200 

#define 

SIEXEC 

00100 


FILES 

/ usr/include/ sys/types.h 
/usr/include/sys/stat.h 

SEE ALSO 

stat(2), types(5). 


/» type of file */ 

/» directory */ 

/* character special */ 

/* block special */ 

/* regular «/ 

/• fifo */ 

/• set user id on execution */ 

/* set group id on execution •/ 

/* save swapped text even after use */ 
/* read permission, owner */ 

/« write permission, owner »/ 

/* execute/search permission, owner */ 
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NAME 

term — conventional names for terminals 
DESCRIPTION 

These names are used by certain commands (e.g., tabsi 1), man(X) and are 
maintained as part of the shell environment (see sh (1), profile {A), and 
environ (5)) in the variable STERM: 


1520 
1620 
1620-12 
2621 
2631 
2631— c 
2631— e 
2640 
2645 
300 

300-12 

300s 

382 

300s- 12 
3045 
33 
37 

40-2 

40-4 

4540 

3270 

4000a 

4014 

43 

450 

450-12 

735 

745 

dumb 


sync 

hp 

lp 

tnl200 

tn300 


Datamedia 1520 

DIABLO 1620 and others using the HyType II printer 
same, in 12-pitch mode 
Hewlett-Packard 2621 series 
Hewlett-Packard 263 1 line printer 
Hewlett-Packard 263 1 line printer - compressed mode 
Hewlett-Packard 263 1 line printer - expanded mode 
Hewlett-Packard 2640 series 

Hewlett-Packard 264n series (other than the 2640 series) 
DASI/DTC/GSI 300 and others using the HyType I printer 
same, in 12-pitch mode 
DASI/DTC/GSI 300s 
DTC 382 

same, in 12-pitch mode 

Datamedia 3045 

TELETYPE® Model 33 KSR 

TELETYPE Model 37 KSR 

TELETYPE Model 40/2 

TELETYPE Model 40/4 

TELETYPE Model 4540 

IBM Model 3270 

Trendata 4000a 

TEKTRONIX 4014 

TELETYPE Model 43 KSR 

DASI 450 (same as Diablo 1620) 

same, in 12-pitch mode 

Texas Instruments TI735 and TI725 

Texas Instruments TI745 

generic name for terminals that lack reverse 

line-feed and other special escape sequences 

generic name for synchronous TELETYPE 

4540-compatible terminals 

Hewlett-Packard (same as 2645) 

generic name for a line printer 

User Electric TermiNet 1 200 

User Electric TermiNet 300 


Up to 8 characters, chosen from [— a— z0— 9], make up a basic terminal name. 
Terminal sub-models and operational modes are distinguished by suffixes begin- 
ning with a — . Names should generally be based on original vendors, rather 
than local distributors. A terminal acquired from one vendor should not have 
more than one distinct basic name. 


Commands whose behavior depends on the type of terminal should accept argu- 
ments of the form — T term where term is one of the names given above; if no 
such argument is present, such commands should obtain the terminal type from 
the environment variable STERM, which, in turn, should contain term. 
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SEE ALSO 

profile (4), environ (5). 

man(l), mm(l), nroff(l), tplot(lG), sh(l), stty(l), tabs(l) in the UNIX Sys- 
tem V User Reference Manual. 

BUGS 

This is a small candle trying to illuminate a large, dark problem. Programs 
that ought to adhere to this nomenclature do so somewhat fitfully. 
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NAME 

types — primitive system data types 
SYNOPSIS 

#include <sys/types.h> 


DESCRIPTION 

The data types defined in the include file are used in UNIX system code; some 
data of these types are accessible to user code: 


typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 


struct { int r[ 1 ]; } * 

long 

daddrt; 

char • 

caddr_t; 

unsigned int 

uint; 

unsigned short 

ushort; 

ushort 

ino_t; 

short 

cntt; 

long 

timet; 

int 

label_t[ 10]; 

short 

dev_t; 

long 

ofift; 

long 

paddrt; 

long 

key_t; 


physadr; 


The form daddrj is used for disk addresses except in an i-node on disk, see 
fs( 4). Times are encoded in seconds since 00:00:00 GMT, January 1, 1970. 
The major and minor parts of a device code specify kind and unit number of a 
device and are installation-dependent. Offsets are measured in bytes from the 
beginning of a file. The label J variables are used to save the processor state 
while another process is running. 


SEE ALSO 

fs (4) . 
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NAME 

values — machine-dependent values 

SYNOPSIS 

#include <values.h> 

DESCRIPTION 

This file contains a set of manifest constants, conditionally defined for particu- 
lar processor architectures. 

The model assumed for integers is binary representation (one’s or two’s comple- 
ment), where the sign is represented by the value of the high-order bit. 

BITS(rype) The number of bits in a specified type (e.g., int). 

HIBITS The value of a short integer with only the high-order bit 

set (in most implementations, 0x8000). 

HIBITL The value of a long integer with only the high-order bit 

set (in most implementations, 0x80000000). 

HIBITI The value of a regular integer with only the high-order 

bit set (usually the same as HIBITS or HIBITL). 

MAXSHORT The maximum value of a signed short integer (in most 

implementations, 0x7FFF = 32767). 

MAXLONG The maximum value of a signed long integer (in most 

implementations, 0x7FFFFFFF = 2147483647). 

MAXINT The maximum value of a signed regular integer (usually 

the same as MAXSHORT or MAXLONG). 

MAXFLOAT, LN MAXFLOAT The maximum value of a single-precision 

floating-point number, and its natural loga- 
rithm. 

MAXDOUBLE, LN MAXDOUBLE The maximum value of a double-precision 

floating-point number, and its natural loga- 
rithm. 

MINFLOAT, LN MINFLOAT The minimum positive value of a single- 
precision floating-point number, and its 
natural logarithm. 

MINDOUBLE, LNMINDOUBLE The minimum positive value of a double- 
precision floating-point number, and its 
natural logarithm. 

FSIGNIF The number of significant bits in the mantissa of a 

single-precision floating-point number. 

DSIGNIF The number of significant bits in the mantissa of a 

double-precision floating-point number. 

FILES 

/usr/include/values.h 

SEE ALSO 

intro(3), math (5). 
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NAME 

varargs — handle variable argument list 
SYNOPSIS 

#include <varargs.h> 

va_alist 

va_dcl 

void vastart(pvar) 
vajist pvar; 

type va_arg(pvar, type) 
vajist pvar; 

void va_end(pvar) 
vajist pvar; 

DESCRIPTION 

This set of macros allows portable procedures that accept variable argument 
lists to be written. Routines that have variable argument lists (such as 
printfi 3S) ) but do not use varargs are inherently nonportable, as different 
machines use different argument-passing conventions. 

vaalist is used as the parameter list in a function header. 
va_dcl is a declaration for va alist. No semicolon should follow vajcl. 
vajist is a type defined for the variable used to traverse the list. 
va_start is called to initialize pvar to the beginning of the list. 

va arg will return the next argument in the list pointed to by pvar. Type is the 
type the argument is expected to be. Different types can be mixed, but it is up 
to the routine to know what type of argument is expected, as it cannot be 
determined at runtime. 

va_end is used to clean up. 

Multiple traversals, each bracketed by vajtart ... va end, are possible. 
EXAMPLE 

This example is a possible implementation of execl (2). 

#include < varargs. h> 

#define MAXARGS 100 

/* execl is called by 

execKfile, argl, arg2, ..., (char »)0); 

*/ 

execl (va alist) 
vadcl 
{ 

vajist ap; 
char »file; 

char *args[MAXARGS]; 
int argno = 0; 

va_start(ap); 

file = va_arg(ap, char »); 

while ((args[argno++] = va_arg(ap, char *)) != (char *)0) 

» 

vaend(ap); 

return execv(file, args); 
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SEE ALSO 

exec(2), printf(3S). 

BUGS 

It is up to the calling routine to specify how many arguments there are, since it 
is not always possible to determine this from the stack frame. For example, 
execl is passed a zero pointer to signal the end of the list. Printf can tell how 
many arguments are there by the format. 

It is non-portable to specify a second argument of char, short, or float to 
va_arg, since arguments seen by the called function are not char, short, or 
float. C converts char and short arguments to int and converts float arguments 
to double before passing them to a function. 
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